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Preface 


Intended Audience 

This manual is intended for all programmers using VAX RMS data files. This 
audience includes high-level language users who use only their language's 
input/output statements. 


Structure of This Document 

This document is composed of six major sections. 

The Format Section is an overview of the Edit/FDL and Create/FDL utilities 
and is intended as a quick reference guide. The format summary contains the 
DCL commands that invoke the Edit/FDL and Create/FDL utilities, and lists 
all command qualifiers and parameters. The usage summary describes how 
to invoke and exit from the Edit/FDL and Create/FDL utilities, how to direct 
output, and any restrictions you should be aware of. 

The Description Section explains how to use the File Definition Language, the 
Edit/FDL Utility, and the Create/FDL Utility. 

The Create/FDL Qualifier Section describes the DCL command qualifier. 

The Edit/FDL Qualifier Section describes the DCL command qualifiers. Each 
qualifier appears in alphabetical order. 

The Edit/FDL Command Section describes each Edit/FDL Utility command. 
Commands appear in alphabetical order. 

The Examples Section contains examples of common operations that you 
perform with the Edit/FDL Utility. 


Associated Documents 

To use the File Definition Language Facility, you should also be familiar with 
the following manuals: 

• Guide to VAX/VMS File Applications 

• VAX/VMS Analyze/RMS—File Utility Reference Manual 

• VAX/VMS Convert and Convert/Reclaim Utility Reference Manual 

• VAX Record Management Services Reference Manual 






Preface 


Conventions Used in This Document 


Convention 

Meaning 

TretI 

A symbol with a one- to three-character 
abbreviation indicates that you press a key on 
the terminal, for example, 1 ret| . 

|CTRL/x| 

The phrase CTRL/x indicates that you must press 
the key labeled CTRL while you simultaneously 
press another key, for example, CTRL/C, CTRL/Y, 
CTRL/O. 

$ SHOW TIME 

04-FEB-1986 11:55:22 

Command examples show all output lines or 
prompting characters that the system prints 
or displays in black letters. All user-entered 
commands are shown in red letters. 

$ TYPE MYFILE.DAT 

Vertical series of periods, or ellipsis, mean either 
that not all the data that the system would display 
in response to the particular command is shown or 
that not all the data a user would enter is shown. 

file-spec, . . . 

Horizontal ellipsis indicates that additional 
parameters, values, or information can be entered. 

[logical-name] 

Square brackets indicate that the enclosed item 
is optional. (Square brackets are not, however, 
optional in the syntax of a directory name in a 
file specification or in the syntax of a substring 
specification in an assignment statement.) 

quotation marks 
apostrophes 

The term quotation marks is used to refer to 
double quotation marks ("). The term apostrophe 
(') is used to refer to a single quotation mark. 










New and Changed Features 


Descending Data Types 

New descending data types have been added, allowing the user to choose 
between the default ascending sort order and descending sort order for 
indexed records. 

The new data types are as follows: 


Data Type 


DBIN2 

DBIN4 


DBIN8 

DDECIMAL 


DINT2 

DINT4 


DINT8 

DSTRING 



Description 

Unsigned 2-byte binary number between 0 and 65,535 

Unsigned 4-byte binary number between 0 and 4,294,967,295 

< 2 16 ) 

Unsigned 8-byte binary number between 0 and 2 64 

Packed decimal value in a continuous string of between 1 and 16 
bytes 

Signed 2-byte integer between -32,768 and +32,767 

Signed 4-byte integer between -2,147,483,648 and 
+2,147,483,647 

Signed 8-byte integer between -2 63 and +2 63 -1 
ASCII string with maximum length of 255 characters 


ix 


















File Definition Language 


File Definition Language 

File Definition Language (FDL) is a special-purpose language used to 
write specifications for data files. These specifications are written 
in text files called FDL files; they are then used by the VAX RMS 
utilities and library routines to create the actual data files. 

One of the RMS utilities, EDIT/FDL, can help you create these FDL 
files. EDIT/FDL was developed especially to manipulate FDL files. 

It has some special features designed to simplify the process of 
creating an FDL file and should be used in most cases. 

Another RMS utility, CREATE/FDL, uses the specifications in an 
existing FDL file to create a new, empty data file. 


CREATE/FDL CREATE/FDL =fdl-file-spec [file-spec] 

FORMAT _ 

Command Qualifier Default 

/[NOJLOG /NOLOG 

Command Parameters 

fdl-file-spec 

Specifies the FDL file from which to create the data file. The default file type 

is FDL. 

file-spec 

Specifies an optional file specification for the created file. If you specify a 
complete file specification, it will override any that may be contained in the 
FDL file. The default file type is FDL. 


EDIT/FDL 

FORMAT 


EDIT/FDL fdl-file-spec 


Command Qualifiers 

/ANALYSIS=fdl-file-spec 

/CREATE 

/DISPLA Y=graph-option 
/EMPHASIS=tuning-bias 
/GRA NULA Rl TY=n 
/[NOJINTERACTIVE 
/NUMBER—KEYS=n 
/OUTPUT=fdl-file-spec 
/PROMPTING=prompt-option 
/RESPONSES=response-option 
/[NO]SCRIPT=script-title 

Command Parameter 

fdl-file-spec 


Defaults 

None. 

None. 

/DISPLA Y=LINE 

/EMPHA SIS=FLA TTER—FILES 

/GRANULARITY=THREE 

/INTERACTIVE 

/NUMBER—KEYS= 1 

None. 

/PROMPTING=FULL 

/RESPONSES=A UTOMA TIC 

/NOSCRIPT 


Specifies the FDL file to be created, modified, or optimized during this 
session. The default file type is FDL. 
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File Definition Language 

Description 


usage summary invoking 

Invoke the Create/FDL Utility by typing the CREATE/FDL command at the 
DCL command level. 

Invoke the Edit/FDL Utility by typing the EDIT/FDL command at the DCL 
command level. 

Exiting 

Exit the Create/FDL Utility by letting it run to successful completion. 

Exit the Edit/FDL Utility by typing either the EXIT command or the QUIT 
command after the menu prompt. Typing CTRL/Z has the same effect as 
the EXIT command, and typing CTRL/C has the same effect as the QUIT 
command. 

Directing Output 

CREATE/FDL produces the empty data file specified by either the command 
line or the FDL file. 

EDIT/FDL produces a new version of the input file, unless the /OUTPUT 
qualifier is used to direct the output to a different file. 

Privileges/Restrictions 

None. 


commands Syntax 

short question (Keyword)[default] : command 


File Definition Language Commands 

ADD 

DELETE 

EXIT 

HELP 

INVOKE 

MODIFY 

QUIT 

SET 

VIEW 


DESCRIPTION The FDL Facility is comprised of the File Definition Language, the Create 

/FDL Utility, and the Edit/FDL Utility. 

The description of the facility is divided into three parts. 

Section 1 describes the FDL primary and secondary attributes. Section 2 
explains how to create FDL files, primarily by using EDIT/FDL. Section 3 
describes how FDL files are used by the VAX RMS utilities and callable 
routines. 


1 File Definition Language 

File design is one of the most important parts of efficient data processing, 
and the File Definition Language (FDL) helps you define specifications for 
data files. Section 1.1 gives a brief overview of the primary and secondary 
attributes. Sections 1.1.1 through 1.1.11 list each primary attribute in 
alphabetical order and give detailed explanations of their secondary attributes. 
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File Definition Language 

Description 


1.1 


FDL Primary and Secondary Attributes 

An FDL file consists of a collection of file attributes grouped into related 
sections. The 13 section headings are called primary attributes: 

• TITLE 

• IDENT 

• SYSTEM 

• FILE 

• DATE 

• RECORD 

• ACCESS 

• SHARING 

• CONNECT 

• AREA 

• KEY 

• ANALYSIS_OF_AREA 

• ANALYSIS_OF_KEY 


The primary attributes must be specified in this order. 

TITLE, IDENT, AREA, KEY, ANALYSIS_OF_AREA, and ANALYSIS_OF_ 
KEY take values. 


SYSTEM, FILE, DATE, RECORD, ACCESS, SHARING, and CONNECT do 
not take values. They do, however, serve as labels for the sections. 

The ANALYSIS_OF_AREA and ANALYSIS_OF_KEY sections appear only 
in FDL files created with the Analyze/RMS_File Utility. 

Attributes within a section are called secondary attributes. Certain secondaries 
can have a third level of attributes called qualifiers. A completed FDL file 
consists of attribute keywords followed by their assigned values. Lowercase 
letters are legal anywhere; they are equivalent to uppercase letters. 

The description of these attributes and the secondary attributes contains 
cross-references to the fields (parameters) of the VAX RMS control blocks. 

The value assigned to an attribute must be one of the following types. 


Switch 


Keyword 
String value 


Number 


Is a logical value, set to TRUE (YES) or FALSE (NO). TRUE or 
YES sets the attribute; FALSE or NO clears it. TRUE, YES, 
FALSE, and NO can be specified as T, Y, F, and N. 

Is an actual word that you must type after the attribute name. 
You can truncate a keyword to its unique characters. 

Is a character string that you must type after the attribute 
name. The null string is a valid string value. You should 
enclose a string value in a pair of apostrophes or quotation 
marks. 

Is a decimal number. 


Throughout this description, the term "DECnet operations" refers to remote 
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File Definition Language 

Description 


file access between two VAX/VMS systems. Unless stated otherwise, 
attributes are supported for DECnet operations. 


1.1.1 ACCESS Section 

The ACCESS section allows you to specify the file processing operations you 
want performed on your file. The ACCESS keyword itself takes no values. 
Table FDL-1 lists the ACCESS secondary attributes and their default values. 


Table FDL-1 Default Values for ACCESS Secondaries 


Secondary 

Default Value 

BLOCK_IO 

FALSE 

DELETE 

FALSE 

GET 

GET when performing an Open service 

PUT 

PUT when performing a Create service 

RECORD_IO 

FALSE 

TRUNCATE 

FALSE 

UPDATE 

FALSE 


BLOCK—IO 

Is a switch specifying that block I/O operations involving Read or Write RMS 
services will be performed, depending on whether you have specified the 
GET (Read service) or the PUT (Write service) ACCESS secondary attributes. 
If you specify BLOCK_IO, no record I/O operations (such as delete, get, put, 
truncate, or update) can be performed. This secondary also allows you to use 
the Space service. 

This attribute corresponds to the FAB$B_FAC field, the BIO option. 

DELETE 

Is a switch allowing Delete RMS operations to be performed. 

This attribute corresponds to the FAB$B_FAC field, the DEL option. 

GET 

Is a switch allowing Get or Find RMS services. GET is the default when you 
are opening the file, and one of the following conditions exists: 

• No other ACCESS section secondary attribute is defined. 

• The DELETE or UPDATE secondary attributes in the SHARING section 
have been specified. 

If you also specify the BLOCK_IO attribute, you may perform Read services. 
This attribute corresponds to the FAB$B_FAC field, the GET option. 

PUT 

Is a switch allowing Put or Extend RMS services. PUT is the default when 
you are creating a file. If you also specify the BLOCK_IO attribute, you can 
perform Write services. 

This attribute corresponds to the FAB$B_FAC field, the PUT option. 
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Description 


RECORD—IO 

Is a switch allowing mixed record I/O and block I/O operations under certain 
circumstances (see the VAX Record Management Services Reference Manual for 
more information). 

This attribute corresponds to the FAB$B_FAC field, the BRO option. 

TRUNCATE 

Is a switch allowing Truncate RMS operations. 

This attribute corresponds to the FAB$B_FAC field, the TRN option. 

UPDATE 

Is a switch permitting Update or Extend RMS services. 

This attribute corresponds to the FAB$B_FAC field, the UPD option. 


1.1.2 ANALYSIS_OF_AREA Section 

The ANALYSIS_OF_AREA section is created and supplied with values by 
the Analyze/RMS_File Utility. This section will only appear in FDL files that 
describe indexed files. 

This primary section has only one secondary—RECLAIMED_SPACE. 

RECLAIMED_SPACE 

ANALYZE/RMS—FILE will supply a number value for this secondary. The 
value is the number of blocks in the area that were reclaimed with the 
Convert Utility (using the /RECLAIM qualifier). For more information about 
using CONVERT/RECLAIM, see the VAX/VMS Convert and Convert/Reclaim 
Utility Reference Manual. 


1.1.3 ANALYSIS_OF_KEY Section 

The ANALYSIS_OF_KEY section is created and supplied with values by the 
Analyze/RMS_File Utility. It will appear only in FDL files that define an 
indexed file. 

The Edit/FDL Utility uses the ANALYSIS_OF_KEY section in its Optimize 
script. 

The primary attribute ANALYSIS_OF_KEY has a value that is the number of 
the key being analyzed (0 is the primary key). 

Table FDL-2 lists the ANALYSIS_OF_KEY secondary attributes. All values 
returned to the attributes are of the numerical type. 

Table FDL-2 ANALYSIS—OF_KEY Secondaries 

Secondary Default Value 

DATA-FILL None. 

DATA_KEY_COMPRESSION None. 

DATA_RECORD_ None. 

COMPRESSION 

DATA_RECORD_COUNT None. 

DATA_SPACE_OCCUPIED None. 

DEPTH None. 

DUPLICATES_PER_SIDR None. 
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Description 


Table FDL-2 (Cont.) AIMALYSIS_OF_KEY Secondaries 


Secondary 


Default Value 


INDEX—COMPRESSION 
INDEX-FILL 


None. 

None. 

None. 

None. 

None. 

None. 


INDEX _SPACE_OCCUPIED 


LEVEL 1 -RECORD-COUNT 

MEAN_DATA_LENGTH 

MEAN_INDEX_LENGTH 


DATA_FILL 

Shows the percentage of bytes per bucket in the data level that has been 


filled. 


DATA_KEY_COMPRESSION 

Shows the percentage of compression that has occurred in the primary keys. 
If the keys added up to 1000 bytes and compression reduced that figure to 
600 bytes, the value shown in the DATA-KEY-COMPRESSION attribute 
would be 40 (for 40%). 

It is possible to get negative compression due to the overhead involved. If 
you see a negative value, you should disable that type of compression in the 
KEY section. 

DATA_RECORD_COMPRESSION 

Is the percentage of compression that has occurred in the level 0 data record. 
If the data records added up to 100,000 bytes and compression reduced 
that figure to 70,000 bytes, the value shown in the DATA_RECORD_ 
COMPRESSION attribute would be 30 (for 30%). 

It is possible to get negative compression due to the overhead involved. If 
you see a negative value, you should disable that type of compression in the 
KEY section. 

This attribute applies only to the primary key. 

DATA-RECORD-COUNT 

Shows the number of data records. 

DATA—SPACE—OCCUPIED 

Shows the size in blocks of the level 0 of the index structure. 

DEPTH 

Shows the number of index levels in the index structure. The value does not 
include the data level. 

DUPLICATES—PER—SIDR 

Shows the average number of duplicate key values for the secondary index 
data records (SIDR); that is, the value is the total number of duplicates 
divided by the total number of SIDRs. 

This attribute applies only to alternate keys. 
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Description 


1.1.4 


INDEX-COMPRESSION 

Shows the percentage of compression that has occurred in the index records 
within the index levels. If the full indexes amounted to 10,000 bytes and 
compression reduced this value to 8000 bytes, the value shown in the 
INDEX—COMPRESSION attribute would be 20 (for 20%). 

INDEX-FILL 

Shows the percentage of bytes per bucket that have been filled in the index 
levels. 

INDEX-SPACE-OCCUPIED 

Shows the size in blocks of the index levels (level 1 and greater). 

LEVEL1-RECORD-COUNT 

Indicates the number of records in the level 1 index, which is the index level 
immediately above the data. It makes the tuning algorithm of EDIT/FDL 
more accurate when duplicate key values (for SIDRs) have been specified, 
even when SIDR overflow buckets exist. 

Generally, every bucket on level 0 of an alternate key has a pointer record 
from level 1 of that alternate key. However, there are no pointers from level 
1 to any overflow buckets. However, LEVEL1—RECORD—COUNT keeps 
track of how many records are in level 1, particularly when duplicate key 
values force overflow buckets to be created. 

MEAN-DATA-LENGTH 

Shows the average length in bytes of the data records. This does not take 
compression into account. 

MEAN_INDEX_LENGTH 

Is the average length in bytes of the index records. This does not take 
compression into account. 

AREA Section 

Areas are RMS-specific regions of an indexed file. You cannot create or 
manipulate these areas from a higher-level programming language. Instead, 
VAX RMS automatically creates various areas for you when you create an 
indexed file. 

If you want to create or manipulate areas in an indexed file, you must include 
the AREA primary attibute in an FDL file. The AREA primary acts as a 
header for a section in the FDL file that describes areas. It takes a value 
that must be a number in the range of 0 to 254. The number identifies the 
area. To define multiple areas for an indexed file, you must specify a separate 
AREA section for each area. 

Most AREA secondaries (except EXACT-POSITIONING, POSITION, and 
VOLUME) have corresponding FILE secondaries. Any values you specify 
for these AREA secondaries override any you specify for the corresponding 
secondaries in the FILE section. 

This attribute corresponds to the XAB$B_AID field. 

Table FDL-3 lists the AREA secondary attributes and their default values. 
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Description 


Table FDL-3 Default Values for AREA Secondaries 


Secondary 

Default Value 

ALLOCATION 

0 

BEST_TRY_CONTIGUOUS 

FALSE 

BUCKET-SIZE 

0 

CONTIGUOUS 

FALSE 

EXACT-POSITIONING 

FALSE 

EXTENSION 

0 

POSITION 

NONE 

VOLUME 

0 


ALLOCATION 

Sets the number of blocks that you will initially allocate for this area. Its 
value must be an integer in the range of 0 to 4,294,967,295. The default is 0, 
which means that the system will not allocate space for this area. 

This attribute corresponds to the XAB$L__ALQ field. 

BEST_TRY_CONTIGUOUS 

Is a switch that controls whether the area will be allocated contiguously if 
there is enough space for it. If the switch is set to YES and there is enough 
space for the area, the area will be allocated contiguously. If the switch is set 
to YES and there is not enough space, the area is allocated noncontiguously. 

If the switch is set to the default NO, this attribute has no effect. 

This attribute corresponds to the XAB$B_AOP field, the CBT option. 

BUCKET_SIZE 

Sets the number of blocks per bucket for this area. Its value must be an 
integer in the range of 0 to 63. The default value is 0, which means that 
VAX RMS calculates the smallest bucket size capable of holding the largest 
record. If the file is to be processed by RMS-11, the bucket size is limited to 
32 blocks. 

This attribute corresponds to the XAB$B_BKZ field. 

CONTIGUOUS 

Is a switch that controls whether the file must be allocated contiguously. 

When the switch is set to YES, this attribute means that the area must be 
allocated contiguously. If there is not enough contiguous space for the area, 
you will receive an error when you try to create the data file. 

With the switch set to the default NO, this attribute is ignored. 

This attribute corresponds to the XAB$B_AOP field, the CTG option. 

EXACT_POSITIONING 

Is a switch, set by default to NO. When this switch is set to YES, then the 
exact positioning of the area that you specified with either the POSITION 
CYLINDER or the POSITION LOGICAL attributes must take place 
successfully, or else an error will occur. 

When the switch is set to NO, the system will position the area as close as 
possible to the location requested. 
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This attribute corresponds to the XAB$B_AOP field, the HRD option. 

EXTENSION 

Sets the number of blocks for the default extension quantity for the area. The 
extension is the amount of space that the system will add to the area when 
the area is filled up. 

The value must be an integer in the range of 0 to 65,535. The default is 
0, which means that the extension size will be determined by the system 
whenever the area requires extending. 

This attribute corresponds to the XAB$W_DEQ field. 


POSITION 

The POSITION attribute controls the positioning of the area. Its value must 
be one of the following keywords: 


ANY_CYLINDER Begins the area on a cylinder boundary, but it does not matter 
which cylinder. 

CYLINDER Begins the area on the boundary of the cylinder specified by 

number. 

FILE_ID Places the area as close to the specified file as possible. The 

file must exist. The value that you specify must be a valid file 
ID containing the file identification number, the file sequence 
number, and the relative volume number. It has the form 
(parentheses included): 

(FID-num,FID-seq,RVN) 


FILE—NAME 


LOGICAL 

NONE 

VIRTUAL 


This attribute is not supported for DECnet operations; NONE 
is used. 

Places the area as close to the specified file as possible. The 
file must exist. The value that you specify must be a valid 
file specification. This attribute is not supported for DECnet 
operations; NONE is used. 

Begins the area at a logical block, specified by number. 

Means that you do not want to control the placement of the 
area. NONE is the default value. 

Begins the area at a virtual block, specified by number. 


The POSITION attribute corresponds to the XAB$B_ALN, XAB$L_LOC, and 
XAB$W_RFI fields. 


VOLUME 

Specifies the relative number of the volume in a Files-11 disk volume set on 
which the area is to reside. 

This value must be an integer in the range of 0 to 255. 

The default is 0, which means that you do not want to control the volume 
placement of the area. 

This attribute corresponds to the XAB$W_VOL field. 
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1.1.5 CONNECT Section 

The CONNECT section specifies run-time attributes that are application- 
dependent and related to record access and performance. The CONNECT 
keyword itself takes no values. Table FDL-4 lists the CONNECT secondary 
attributes and their default values. 


Table FDL-4 Default Values for CONNECT Secondaries 


Secondary 

Default Value 

ASYNCHRONOUS 

None. 

BL0CK_I0 

None. 

BUCKET.JO 

None. 

CONTEXT 

None. 

END_OF_FILE 

None. 

FAST_DELETE 

None. 

FILI_BUCKETS 

None. 

KEY_GREATER_EQUAL 

None. 

KEY_GREATER_THAN 

None. 

KEY_LIMIT 

None. 

KEY_OF_REFERENCE 

None. 

LOCATE—MODE 

None. 

LOCK_ON_READ 

None. 

LOCK_ON_WRITE 

None. 

MANUAL-UNLOCKING 

None. 

MULTIBLOCK_COUNT 

None. 

MULTIBUFFER—COUNT 

None. 

NOLOCK 

None. 

NONEXISTENT_RECORD 

None. 

READ_AHEAD 

None. 

READ_REGARDLESS 

None. 

TIMEOUT-ENABLE 

None. 

TIMEOUT-PERIOD 

None. 

TRUNCATE_ON_PUT 

None. 

TT-CANCEL -CONTROL _0 

None. 

TT-PROMPT 

None. 

TT_PURGE—TYPE—AHEAD 

None. 

TT_READ_NOECHO 

None. 

TT_READ_NOFILTER 

None. 

TT_UPCASE_INPUT 

None. 

UPDATE—IF 

None. 

WAIT—FOR—RECORD 

None. 

WRITE-BEHIND 

None. 
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ASYNCHRONOUS 

Is a switch indicating that I/O operations are to be performed 
asynchronously. When you specify this attribute, VAX RMS returns control 
to your program as soon as an I/O operation is initiated, even though that 
operation may not yet be completed. ASY is ignored for process permanent 
files. 

This attribute corresponds to the RAB$L__ROP field, the ASY option. 

BLOCK_IO 

Is a switch that controls whether block or record I/O operations are 
performed. If the switch is set to YES, block operations only are permitted. 

If the switch is set to NO, only record operations will be allowed for relative 
and indexed files. However, if the ACCESS Section RECORD_IO attribute 
has also been specified, both block and record operations may be performed 
on sequential files. 

This attribute corresponds to the RAB$L_ROP field, the BIO option. 

BUCKET_IO 

Contains a relative record number or a numeric value representing the virtual 
block number to be accessed. This attribute is used with records in a relative 
file or when you want block I/O to be performed. 

This attribute corresponds to the RAB$L_BKT field. 

CONTEXT 

Contains any user-selected value, up to 4 bytes in length. CONTEXT is 
devoted exclusively to your use. VAX RMS does not use this attribute, so 
you can put any value you want in it. For example, you could use it to 
communicate with a completion routine in your program. 

This attribute corresponds to the RAB$L_CTX field. 

END_OF_FILE 

Is a switch indicating that VAX RMS is to position to the end of the file when 
a Connect operation takes place. 

This attribute corresponds to the RAB$L_ROP field, the EOF option. 

FAST-DELETE 

Is a switch specifying that pointers from the alternate indexes that allow 
duplicates are not to be deleted as soon as you delete a record. Instead, the 
pointers are deleted when you try to access the deleted record, in which case 
an error message is returned. In other words, the FAST_DELETE attribute 
prevents the overhead associated with the usual way VAX RMS deletes a 
record—updating the data level, the primary index, and then the alternate 
indexes. 

This attribute corresponds to the RAB$L_ROP field, the FDL option. 

FILI_BUCKETS 

Is a switch specifying that VAX RMS is to load buckets according to the fill 
size established at file-creation time. 

If the switch is not set, VAX RMS ignores the established bucket fill size, and 
fills buckets completely. 

This attribute corresponds to the RAB$L_ROP field, the LOA option. 
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KEY_GREATER_EQUAL 

When using an ascending data type, KEY-GREATER—EQUAL is a switch 
requesting VAX RMS to access the first record in an indexed file that contains 
a value (for the specified key of reference) greater than or equal to the value 
described by the RAB$L_KBF and RAB$B_KSZ fields. If you are using a 
descending data type, then KEY—GREATER—EQUAL will access the first 
record that contains a value for the specified key of reference less than or 
equal to the value described by the RAB$L_KBF and RAB$B_KSZ fields. 

For more information on the fields RAB$L_KBF and RAB$B__KSZ, refer to 
the VAX Record Management Services Reference Manual. 

If neither this switch nor the KEY—GREATER—THAN switch is set, a key 
equal match is made. 

This attribute corresponds to the RAB$L_ROP field, the KGE option. 

KEY_GREATER_THAN 

When using an ascending data type, the KEY—GREATER—THAN attribute 
is a switch requesting VAX RMS to access the first record in an indexed file 
that contains a value (for the specified key of reference) greater than the 
value described by the RAB$L_KBF and RAB$B_KSZ fields. When using 
a descending data type, the KEY—GREATER—THAN attribute requests VAX 
RMS to access the first record that contains a value less than that specified 
in the RAB$L_KBF and RAB$B_KSZ fields. For more information on the 
RAB$L_KBF and RAB$B_KSZ field, refer to the VAX Record Management 
Services Reference Manual. 

If neither this switch nor the KEY—GREATER—EQUAL switch is set, a key 
equal match is made. 

This attribute corresponds to the RAB$L_ROP field, the KGE option. 

KEY-LIMIT 

Is a switch indicating that the key value described by the RAB$L_KBF and 
RAB$B_KSZ fields is to be compared to the value in the record accessed in 
sequential mode. If this switch is set and the record's key value is greater 
than the limit key value, then the RMS$_OK_LIM status code is returned. 

This attribute corresponds to the RAB$L_ROP field, the LIM option. 

KEY_OF_REFERENCE 

Specifies the key or index (such as primary, or first alternate) by which you 
want to process records in a file. The value 0 indicates the primary key. 
Values 1 through 254 indicate alternate keys. The default value is 0 (primary 
key). 

KEY—OF—REFERENCE is applicable to indexed files only. 

This attribute corresponds to the RAB$B_KRF field. 

LOCATE-MODE 

Is a switch specifying that VAX RMS is to return records by supplying a 
pointer to the data rather than copying the data to the user buffer. 

This attribute corresponds to the RAB$L_ROP field, the LOC option. 

LOCK_ON_READ 

Is a switch specifying that a record is to be locked for read. Other accessors 
may read the record while it is locked, but they may not modify it. 
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If both the LOCK_ON_READ and the LOCK_ON_WRITE attributes are 
specified, LOCK_ON_WRITE takes precedence. The NOLOCK attribute 
takes precedence over both. 

This attribute corresponds to the RAB$L_ROP field, the REA option. 

LOCK—ON_WRITE 

Is a switch specifying that a record is to be locked for modification. Other 
accessors may read the record while it is locked. 

If both the LOCK_ON_WRITE and the LOCK—ON —READ attributes are 
specified, LOCK—ON_WRITE takes precedence. The NOLOCK attribute 
takes precedence over both. 

This attribute corresponds to the RAB$L_ROP field, the RLK option. 

MANUAL-UNLOCKING 

Is a switch specifying that VAX RMS cannot automatically unlock records. 
Instead, once a record is locked (by a Get, Find, or Put operation), it must be 
explicitly unlocked by a Free or Release VAX RMS operation. 

The NOLOCK attribute takes precedence over the MANUAL—UNLOCKING 
attribute. 

This attribute corresponds to the RAB$L_ROP field, the ULK option. 

MULTIBLOCK_COUNT 

Specifies the number of blocks, in the range of 0 to 127, to be allocated to 
each I/O buffer. MULTIBLOCK—COUNT applies only when accessing a 
sequential disk file. 

The MULTIBLOCK—COUNT attribute optimizes data throughput for 
sequential operations, and it does not affect the structure of the file. It 
reduces the number of times you would otherwise have to access the disk for 
record operations, so execution time is likewise reduced. However, the extra 
buffering increases memory requirements. 

If this attribute is not set or is set as 0, the process default for the multiblock 
count is used. If the process default is also 0, RMS uses the system default. 

If the system default is also 0, then the default size for each I/O buffer is 
one block. The DCL command SET RMS_DEFAULT is used to set process or 
system defaults. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the RAB$B_MBC field. 

MULTIBUFFER-COUNT 

Specifies the number of buffers, in the range of 0 to 127, to be allocated at 
connect time. 

If this attribute is not set or is set as 0, VAX RMS uses the process default 
for the particular file organization and device type. If the process default is 
also 0, the system default for the particular file organization and device type 
applies. 

If the system default is likewise 0, one buffer is allocated. However, if 
either the READ—AHEAD or the WRITE—BEHIND attributes are specified, a 
minimum of two buffers are allocated. A minimum of two buffers are also 
allocated for an indexed sequential file or for a process permanent file. 

This attribute is not supported for DECnet operations; it is ignored. 
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This attribute corresponds to the RAB$B_MBF field. 

NOLOCK 

Is a switch specifying that the record accessed through a Get or Find RMS 
operation is not to be locked. The NOLOCK attribute takes precedence 
over all other attributes controlling record locking, such as MANUAL— 
UNLOCKING, LOCK—ON —READ, and LOCK_ON-WRITE. 

This attribute corresponds to the RAB$L_ROP field, the NLK option. 

NONEXISTENT-RECORD 

Is a switch specifying that if a record randomly accessed with a Get or Find 
RMS operation does not exist (was never inserted into the file or was deleted), 
the record is to be processed anyway, locking the record cell if necessary. 

NONEXISTENT—RECORD does not apply to indexed files. 

This attribute corresponds to the RAB$L_ROP field, the NXR option. 

READ-AHEAD 

Is a switch used with multiple buffers (see MULTIBUFFER—COUNT), 
indicating read-ahead operations. It indicates that the system does not 
have to wait for I/O completion since input and computing can overlap. In 
other words, when one buffer is filled, the next record is read into the next 
buffer while the I/O operation takes place for the first buffer. 

If you specify READ—AHEAD when the multibuffer count is 0, two buffers 
are allocated to allow multibuffering. If you specify two or more buffers, 
multibuffering is allowed regardless. However, if you specify a buffer count 
of 1, multibuffering is disabled. 

READ—AHEAD is ignored for unit record device I/O. It applies to sequential 
file processing only. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the RAB$L_ROP field, the RAH option. 

READ-REGARDLESS 

Is a switch specifying that a record is to be read even if it is locked. This 
attribute allows some control over access. In other words, if a record is locked 
against all access and a Find or Get RMS operation is requested, the record is 
returned anyway. 

This attribute corresponds to the RAB$L_ROP field, the RRL option. 

TIMEOUT-ENABLE 

Is a switch specifying that the maximum time value, in seconds, is allowed for 
a record input wait caused by a locked record if the WAIT—FOR—RECORD 
attribute was specified. This attribute also applies to the time allowed for a 
character to be received during terminal input. If the timeout period expires, 
VAX RMS returns an error status. 

In addition, TIMEOUT—ENABLE serves a special purpose for mailbox devices. 
If you specify this attribute with a TIMEOUT—PERIOD of 0, Get and Put 
RMS operations to mailbox devices use the IO$M_NOW modifier. The 
operation then completes immediately instead of synchronizing with another 
cooperating writer or reader of the mailbox. See the VAX /VMS I/O Reference 
Volume for a further discussion of mailboxes. 

This attribute is not supported for DECnet operations; it is ignored. 
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This attribute corresponds to the RAB$L_ROP field, the TMO option. 

TIMEOUT-PERIOD 

Specifies the maximum number of seconds, in the range of 0 through 255, 
that a Get RMS operation can use. If a get operation is specified from the 
terminal and you specify 0, the current contents of the type ahead buffer are 
returned. 

To use this attribute, you must also specify the TIMEOUT_ENABLE attribute. 
This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the RAB$B_TMO field. 

TRUNCATE_ON_PUT 

Is a switch specifying that a Put or Write RMS operation can occur at any 
point in a file, truncating the file at that point. A write operation causes the 
end of file mark to immediately follow the last byte written. 

TRUNCATE_ON_PUT can only be used with sequential files. 

This attribute corresponds to the RAB$L_ROP field, the TPT option. 

TT—CANCEI_CONTROI_O 

Is a switch guaranteeing that terminal output will not be discarded if you 
enter CTRL/O. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the RAB$L_ROP field, the CCO option. 

TT-PROMPT 

Is a switch indicating that the contents of the prompt buffer are to be used as 
a prompt on a read from a terminal. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the RAB$L_ROP field, the PMT option. 

TT_PURGE_TYPE_AHEAD 

Is a switch eliminating any information that may be in the type-ahead buffer 
on a read from a terminal. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the RAB$L_ROP field, the PTA option. 

TT_READ_NOECHO 

Is a switch indicating that input data is not echoed (displayed) on the terminal 
as it is entered on the keyboard. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the RAB$L_ROP field, the RNE option. 

TT_READ_NOFILTER 

Is a switch indicating that CTRL/U, CTRL/R, and DELETE are not to be 
considered control commands on terminal input, but are to be passed to the 
user program. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the RAB$L_ROP field, the RNF option. 
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TT_UPCASE_INPUT 

Is a switch that changes lowercase characters on a read from a terminal to 
uppercase. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the RAB$L_ROP field, the CVT option. 

UPDATE—IF 

Is a switch indicating that if a put operation is specified for a record that 
already exists in the file, the operation is converted to an update. This 
attribute is necessary to overwrite (as opposed to update) an existing record in 
relative and indexed sequential files. 

Indexed files using UPDATE —IF must not allow duplicates on the primary 
key. 

This attribute corresponds to the RAB$L_ROP field, the UIF option. 

WAIT_FOR_RECORD 

Is a switch specifying that VAX RMS should wait for a currently locked record 
until it becomes available. You can use this attribute with the TIMEOUT- 
ENABLE and TIMEOUT—PERIOD attributes to limit waiting periods to a 
specified time. 

This attribute corresponds to the RAB$L_ROP field, the WAT option. 

WRITE-BEHIND 

Is a switch used with multiple buffers (see MULTIBUFFER—COUNT) to 
indicate write-behind operations. It indicates that the system does not have 
to wait for I/O completion because computing and output can overlap. In 
other words, when one buffer is filled, the next record is written into the next 
buffer while the I/O operation takes place for the first buffer. 

If you specify WRITE-BEHIND when the multibuffer count is 0, two buffers 
are allocated to allow multibuffering. If you specify two or more buffers, 
multibuffering is allowed regardless. However, if you specify a buffer count 
of 1, multibuffering is disabled. 

WRITE-BEHIND is ignored for unit record device I/O. It applies to 
sequential file processing only. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the RAB$L_ROP field, the WBH option. 


1.1.6 DATE Section 

The DATE section allows you to specify dates and times for certain file 
characteristics. The DATE keyword itself takes no value; it serves only to set 
off this section. Table FDL-5 lists the DATE secondary attributes and their 
default values. 


Table FDL-5 

Default Values for DATE Secondaries 

Secondary 

Default Value 

BACKUP 

Null-string 

CREATION 

Null-string 

EXPIRATION 

Null-string 

REVISION 

Null-string 
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In general, you should let the system specify values for the DATE secondaries. 
The only secondary you can routinely (and safely) set is EXPIRATION. 

BACKUP 

Is a string that indicates the date when the data file was last backed up. It 
must be of this form: 

dd-mmm-yyyy hh:mm:ss.cc. 

This attribute corresponds to the XAB$Q_BDT field. 

CREATION 

Is a string that indicates the date and time of the data file's creation. It must 
be of this form: 

dd- mmm -yyyy hh:mm:88.CC. 

This attribute corresponds to the XAB$Q_CDT field. 

EXPIRATION 

Is a string that indicates the date and time after which a disk file may be 
considered for deletion. For magnetic tape files, the EXPIRATION attribute 
sets the date and time after which you can overwrite the file. It must be of 
the form 

dd-mmm-yyyy hh:mm:ss:cc. 

This attribute corresponds to the XAB$Q__EDT field. 

REVISION 

Is a string that indicates the date of the last modification of the data file. It 
must be of this form: 

dd- mmm -yyyy hh • mm•n« rc 

This attribute corresponds to the XAB$Q_RDT field. 

1.1.7 FILE Section 

The FILE section allows you to specify file processing and file-related 
characteristics for your file. The FILE primary keyword takes no value. 

FILE section attributes (ALLOCATION, BEST_TRY_CONTIGUOUS, 
BUCKET-SIZE, CONTIGUOUS, and EXTENSION) have corresponding 
AREA section attributes. If you specify values for these attributes in the 
AREA section, they will override any values that you specify in the FILE 
section. 

Table FDL-6 lists the FILE secondary attributes and their default values. 

Table FDL-6 Default Values for FILE Secondaries 

Secondary Default Value 

ALLOCATION 0 

BEST_TRY_CONTIGUOUS NO 

BUCKET_SIZE 0 

CLUSTER_SIZE 3 

CONTEXT 0 

CONTIGUOUS NO 
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Table FDL—6 (Cont.) 

Default Values for FILE Secondaries 

Secondary 

Default Value 

CREATE_IF 

NO 

DEFAULT_NAME 

Null-string 

DEFERRED_WRITE 

NO 

DELETE_ON_CLOSE 

NO 

DIRECTORY_ENTRY 

YES 

EXTENSION 

0 

GLOBAL _BUFFER_COUNT 

0 

MAXIMIZE—VERSION 

YES 

MT_BLOCK_SIZE 

0 

MT_CLOSE_REWIND 

NO 

MT_CURRENT_POSITION 

NO 

MT_NOT_EOF 

NO 

MT_OPEN_REWIND 

NO 

MT_PROTECTION 

Space character 

MAX_RECORD_NUMBER 

0 

NAME 

Null-string 

NON—FILE—STRUCTURED 

NO 

ORGANIZATION 

SEQUENTIAL 

OUTPUT_FILE_PARSE 

NO 

OWNER 

System or process default 

PRINT—ON—CLOSE 

NO 

PROTECTION 

System or process default 

READ-CHECK 

NO 

REVISION 

0 

SEQUENTIAL-ONLY 

NO 

SUBMIT_ON_CLOSE 

NO 

SUPERSEDE 

NO 

TEMPORARY 

NO 

TRUNCATE—ON_CLOSE 

NO 

USER_FILE_OPEN 

NO 

WINDOW-SIZE 

Volume default 

WRITECHECK 

NO 


ALLOCATION 

Sets the number of blocks that you will initially allocate for the data file. 
The value that you specify must be an integer in the range from 0 to 
4,294,967,295. The default is 0, which means that the system will not 
initially allocate space for the file. 

Note that this attribute can be overridden if you specify the corresponding 
attribute in the AREA section. 

This attribute corresponds to the FAB$L_ALQ field. 
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BEST_TRY_CONTIGUOUS 

Is a switch that controls whether the file will be allocated contiguously if 
there is enough space for it. If the switch is set to YES and if there is enough 
space for the file, the file will be allocated contiguously. If the switch is set to 
YES and there is not enough space, the file will be allocated noncontiguously. 

If the switch is set to the default NO, this attribute is ignored. It is also 
ignored if no allocation is specified. 

Note that this attribute can be overridden if you specify the corresponding 
attribute in the AREA section. 

This attribute corresponds to the FAB$L_FOP field, the CBT option. 

BUCKET-SIZE 

Sets the number of blocks per bucket. Its value must be an integer in the 
range 0 to 63. The default value is 0, which means that the bucket size will 
be computed by VAX RMS to be the smallest bucket size capable of holding 
the largest record. If the file is to be processed by RMS-11, the bucket size is 
limited to 32 blocks. 

If you specify separate areas for the data level and the index levels, then you 
must define separate bucket sizes for each area. In such a case, this attribute 
has no meaning because it is overridden when you specify the corresponding 
attribute in the AREA section. 

This attribute corresponds to the FAB$B_BKS field. 

CLUSTER-SIZE 

Defines the disk cluster size, which is the number of blocks allocated to a 
cluster. The system manager or operator determines the disk cluster size 
when the disk (or volume) is initialized. The disk cluster size can only be set 
when a volume is initialized. 

CLUSTER—SIZE is valid only in the output from the Analyze/RMS—File 
Utility. ANALYZE/RMS—FILE then returns the actual value of the disk 
cluster size to EDIT/FDL for use during an Optimize script. 

Note that the FDL attribute CLUSTER—SIZE does not have the same meaning 
as the cluster-size in the RSTS/E operating system. 

CONTEXT 

Contains a user-specified value 4 bytes long. This field is intended solely for 
your use to convey user information to a completion routine in your program; 
VAX RMS never uses it for record management activities. 

This attribute corresponds to the FAB$L_CTX field. 

CONTIGUOUS 

Is a switch that controls whether the file must be allocated contiguously. 

When the switch is set to YES, the file must be allocated contiguously. If 
there is not enough space for the file's initial allocation, you will receive an 
error. 

When set to the default NO, the attribute is ignored. It is also ignored if no 
allocation is specified. 

Note that this attribute can be overridden if you specify the corresponding 
attribute in the AREA section. 

This attribute corresponds to the FAB$L_FOP field, the CTG option. 
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CREATE—IF 

Is a switch that opens an already existing file. If the switch is set to YES, 
the file is created if it does not exist. The alternate success status RMS$_ 
CREATED is then returned to indicate that the file was created, not just 
opened. It is input only on a RMS Create service. The CREATE _IF attribute 
overrides the SUPERSEDE (supersede existing file) attribute. 

This attribute corresponds to the FAB$L_FOP field, the CIF option. 

DEFAULT-NAME 

Takes a string value that can define portions of the file specification of the 
data file to be created. 

When a utility creates a data file from an FDL file, it first attempts to get 
the file specification from the call to the utility. If you supply a full file 
specification with the call to the utility, then the values for the DEFAULT- 
NAME and NAME attributes are ignored. 

If you supply only a partial file specification when you invoke the creating 
utility, the utility will try to fill in the remainder of the file specification 
from the value of DEFAULT—NAME. If you have not specified a value for 
DEFAULT—NAME, the utility will use the VAX RMS defaults. 

If you have not supplied the utility with a file specification, but have supplied 
a full one with the NAME attribute, the creating utility will use that file 
specification. If you have supplied only a partial file specification with the 
NAME attribute, then the utility will use that portion, and will then look to 
the DEFAULT—NAME attribute for the rest of the file specification. 

If the file specification is still incomplete at that point, the utility will use the 
VAX RMS defaults to complete the file specification. 

For example, if you assigned the value WRKD$:.KSM to DEFAULT—NAME, 
then unless you specified otherwise the created data file would have the 
device name WRKD$ and the file type KSM in its file specification. 

This attribute corresponds to the FAB$L_DNA and the FAB$B_DNS fields. 

DEFERRED-WRITE 

Is a switch that controls whether the writing of modified I/O buffers back 
to the file is deferred until that buffer is needed for other purposes. This 
attribute applies only to relative files and indexed files. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the FAB$L_FOP field, the DFW option. 

DELETE-ON-CLOSE 

Is a switch that defines the file status after being closed. When the switch 
is set to YES, this attribute specifies that the file will be deleted when it is 
closed. 

If you set this attribute to YES, you cannot create the file with CREATE/FDL 
(or with FDL$CREATE). They both open and then close the data file, which 
means that the file will never be around long enough to be used. To create a 
file that has the DELETE— ON_CLOSE attribute set to YES, you must use the 
FDL$PARSE routine. 

When set to the default NO, this attribute is ignored. 

This attribute corresponds to the FAB$L_FOP field, the DLT option. 
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DIRECTORY_ENTRY 

Is a switch that defines the file as a temporary one. When the switch is set 
to the default YES, it means that the file will be created and retained with a 
directory entry. 

When this attribute is set to NO, the file is retained but with no directory 
entry. To access that file, you must use its file ID. 

This attribute corresponds to the FAB$L_FOP field, the TMP option. 

EXTENSION 

Sets the number of blocks for the default extension value for the file. Each 
time that the file is automatically extended, the specified number of blocks 
will be added. The value for this attribute must be an integer in the range 
of 0 to 65,535. The default is 0, which means the extension size will be 
determined by the system whenever the file must be extended. 

Note that this attribute can be overridden if you specify the corresponding 
attribute in the AREA section. 

This attribute corresponds to the FAB$W_DEQ field. 

GLOBAI_BUFFER-COUNT 

Specifies the number of global buffers that will be allocated for the data file. 
The value for this attribute must be a number in the range 0 to 32,767. 

The default value is 0. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the FAB$W_GBC field. 

MAX_RECORD_NUMBER 

Specifies the maximum number of records that can be placed in a relative file. 

The value must be an integer in the range of 0 to 2,147,483,647. The default 
value is 0, which means that you can place as many records as you want in 
the relative file, up to the maximum 2,147,483,647. 

This attribute corresponds to the FAB$L_MRN field. 

MAXIMIZE_VERSION 

Is a switch that controls the version number assigned to the file specification 
of a data file. 

If the switch is set to the default YES, the file specification of the data file will 
have the greater of two possible version numbers. 

The version number will be either the number that was part of the file 
specification or a version number that is one higher than the highest existing 
version number. 

When the switch is set to NO, then giving an explicit version number in the 
file specification that is lower than an existing version will result in creating 
a new data file that has the lower version number. Giving a version number 
in the file specification that exactly matches an existing one will result in an 
error. 

This attribute corresponds to the FAB$L_FOP field, the MXV option. 
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MT_BLOCK_SIZE 

Sets the number of bytes in a block for magnetic tape files. The value for 
this attribute is either 0 or an integer in the range of 20 to 65,535 for ANSI- 
formatted tapes, and 14 to 65,532 for foreign tapes (tapes that are not in the 
standard ANSI format used by the VAX/VMS operating system and that must 
be mounted using the DCL command MOUNT/FOREIGN). If the default 
value of 0 is taken, then the block size that was specified when the tape was 
mounted is used. 

This attribute corresponds to the FAB$W_BLS field. 

MT_CLOSE_REWIND 

Is a switch that controls whether a magnetic tape volume is rewound when 
the file is closed. When the switch is set to YES, the magnetic tape volume is 
rewound. 

When the switch is set to the default value NO, the magnetic tape volume is 
not rewound. 

This attribute corresponds to the FAB$L_FOP field, the RWC option. 

MT_CURRENT_POSITION 

Is a switch that controls the starting position on a magnetic tape where a 
data file is written. When the switch is set to YES, the data file is written 
immediately following the current tape file. 

When the switch is set to the default value NO, the data file is written at the 
beginning of the tape. 

This attribute corresponds to the FAB$L_FOP field, the POS option. 

MT_NOT_EOF 

Is a switch that prevents positioning to the end of a file when a tape file is 
opened and the FAB$B_FAC (file access) field of this FAB indicates an RMS 
Put operation (the ACCESS PUT attribute has been specified). 

This attribute corresponds to the FAB$L_FOP field, the NEF option. 

MT_OPEN_REWIND 

Is a switch that controls whether a magnetic tape volume is rewound before 
any open or create operations. When the switch is set to YES, the magnetic 
tape volume is rewound. 

When the switch is set to the default value NO, the magnetic tape volume 
is not rewound. An open operation begins at the current tape position and 
writes to the end of the tape; a create operation rewinds the tape, but then 
skips over existing data on the tape. This attribute takes precedence over the 
MT_CURRENT_POSITION attribute (FAB$L_FOP field, the POS option). 

This attribute corresponds to the FAB$L_FOP field, the RWO option. 

MT_PROTECTION 

Allows you to control access to a magnetic tape file. By default, this attribute 
takes a space character as its value, which means that access is not controlled. 
If you assign any character other than the space, then to access the file you 
must specify the /OVERRIDE=ACCESSIBILITY qualifier and option when 
you initialize or mount the volume. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the XAB$B_MTACC field. 
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NAME 

Is the file specification of the data file to be created from this FDL file. If you 
supply a creating utility with a name for the data file, that name will override 
the one specified here. 

This attribute corresponds to the FAB$L_FNA and the FAB$B_FNS fields. 

NON_FILE_STRUCTURED 

Indicates that the volume is to be processed in a manner that is not file- 
structured. 

This attribute is not supported for DECnet operations; an error is returned if 
you try to use it. 

This attribute corresponds to the FAB$L_FOP field, the NFS option. 

ORGANIZATION 

Defines the type of file organization. Its value must be one of the following 
keywords: 

• SEQUENTIAL 

• RELATIVE 

• INDEXED 

SEQUENTIAL is the default. 

This attribute corresponds to the FAB$B_ORG field. 

OUTPUT_FILE_PARSE 

Is a switch specifying that the resultant file specification string, if used, is to 
provide directory, file name, and file type defaults only. A NAM block is 
required. 

This attribute corresponds to the FAB$L_FOP field, the OFP option. 

OWNER 

Specifies who will be the owner of the data file. The value that you supply is 
the user identification code (UIC), in this form: 

[octal-group-number,octal-user-number] 

For example, OWNER [12,322] indicates that the person in group 12 with the 
user number 322 will be the owner of the data file. 

This attribute corresponds to the XAB$W_GRP and the XAB$W_MBM fields. 

PRINT_ON_CLOSE 

Is a switch that controls whether the data file is to be spooled to the process 
default print queue when the file is closed. This attribute applies to sequential 
files only. 

When the switch is set to YES, the data file is to be spooled to the process 
default print queue (SYS$PRINT) when the file is closed. 

When the switch is set to the default NO, this attribute is ignored. 

If DELETE _ON —CLOSE is also set to YES, the file is deleted after it is 
printed. 

This attribute corresponds to the FAB$L_FOP field, the SPL option. 
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PROTECTION 

Defines the levels of file protection. 

Its value is a string of one of these two forms: 

(SYSTEM=code,0WNER=code,GR0UP=code,W0RLD=code) 

(SYSTEM:code,OWNER:code.GROUP:code,WORLD:code) 

The code is a protection specification for READ, WRITE, EXECUTE, and 
DELETE in the form: 

[R] [W] [E] [D] 

The default gives the data file the current process default protection. To see 
what this is, issue the DCL command SHOW PROTECTION. 

To deny a specific access right, you omit it from the code. To withhold all 
access rights from a user classification, omit the classification from the list. 

For example, the following string gives all access rights to SYSTEM and 
OWNER, gives only READ access to GROUP, and gives no access rights to 
WORLD. 

(SYSTEM=RWED,OWNER=RWED,GROUP=R) 

This attribute corresponds to the XAB$W_PRO field. 

READ_CHECK 

Is a switch that determines whether transfers from disk volumes will be 
followed by read-compare operations. 

When the switch is set to YES, transfers from disk volumes are followed by 
read-compare operations. This double checking increases the likelihood that 
the system will catch data errors; however, it also increases disk overhead. 

Setting this switch does not permanently mark the file for READ_CHECK; it 

merely sets an RMS run-time option. Instead, you must use the 

SET FILE/DATA_CHECK=READ command to mark the file permanently. 

When the switch is set to the default NO, the attribute is ignored. 

This attribute corresponds to the FAB$L_FOP field, the RCK option. 

REVISION 

Specifies the revision number of the data file. Its value is an integer in the 
range from 0 to 65,535. Unless you want to change the revision number to 
some specific number, you should leave this value at its default of 0. When 
REVISION is set to 0, the file's revision number is increased by one every 
time the file is opened for write access. 

This attribute corresponds to the XAB$W_RVN field. 

SEQUENTIAI_ONLY 

Is a switch indicating that the file can only be processed sequentially, thus 
allowing certain processing optimizations. Any attempt to perform random 
access results in an error. 

For DECnet operations, this attribute enables file transfer mode, a data access 
protocol (DAP) feature that allows several records to be transferred in a single 
network operation. It maximizes throughput for single direction, sequential 
acccess file transfer. 

This attribute corresponds to the FAB$L_FOP field, the SQO option. 
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SUBMIT—ON—CLOSE 

Is a switch, set by default to NO. 

When the switch is set to YES, the data file is submitted to the process default 
batch queue (SYS$BATCH) when the file is closed. This setting makes sense 
only if the data file is a sequential command file. 

When the switch is set to NO, this attribute is ignored. 

If DELETE—ON—CLOSE is also set to YES, the file is deleted after the batch 
job completes. 

This attribute corresponds to the FAB$L_FOP field, the SCF option. 

SUPERSEDE 

Is a switch, set by default to NO. When the switch is set to YES, the existing 
data file is replaced by a different one of the same name, type, and version. 

When the switch is set to NO, this attribute is ignored. 

If you try to create a new file with the same name, type, and version as an 
existing file, the old file will be deleted if the new one is created successfully. 

SUPERSEDE is overridden by the CREATE—IF attribute. 

This attribute corresponds to the FAB$L_FOP field, the SUP option. 

TEMPORARY 

Is a switch indicating that a temporary file is to be created and deleted when 
the file is closed. A directory entry is not created for the temporary file. 

If you set this attribute to YES, you cannot create the file with CREATE/FDL 
(or with FDL$CREATE). They both open and then close the data file, which 
means that the file will never be around long enough to be used. To create 
a file that has the TEMPORARY attribute set to YES, you must use the 
FDL$PARSE routine. 

This attribute corresponds to the FAB$L_FOP field, the TMD option. 

TRUNCATE-ON-CLOSE 

Is a switch set by default to NO. When the switch is set to YES, any unused 
space at the end of a sequential file is deallocated when the file is closed. 
This attribute applies to sequential files only. 

When set to NO, this attribute is ignored. 

This attribute corresponds to the FAB$L_FOP field, the TEF option. 

USER-FILE_OPEN 

Is a switch indicating that VAX RMS only opens or creates a file; no further 
RMS operations are performed on the file. If you specify this option, you 
must also specify the SHARING USER—INTERLOCK attribute unless you 
have also specified the SHARING PROHIBIT attribute. 

This attribute is not supported for DECnet operations; an error is returned if 
you try to use it. 

This attribute corresponds to the FAB$L_FOP field, the UFO option. 
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1 . 1.8 


WINDOW_SIZE 

Specifies the number of retrieval windows (pointers) you want VAX RMS to 
maintain in memory for your file. You can specify a numeric value in the 
range of 0 to 127, or 255. A value of 0 indicates that VAX RMS is to use the 
system default number of retrieval pointers. A value of 255 means to map the 
entire file, if possible. Values between 128 and 254, inclusive, are reserved 
for future use. 

This attribute is not supported for DECnet operations; it is ignored. 

This attribute corresponds to the FAB$B_RTV field. 

WRITE-CHECK 

Is a switch, set by default to NO. When this switch is set to YES, transfers 
to disk are checked by a read-compare operation. However, this operation 
creates extra system overhead. 

Setting this switch does not permanently mark the file for WRITE—CHECK; 
it sets an RMS run-time option. You must use the SET FILE/DATA— 
CHECK=WRITE command to mark the file permanently. 

When set to NO, this attribute is ignored. 

This attribute corresponds to the FAB$L_FOP field, the WCK option. 


KEY Section 

The KEY primary attribute acts as a header for a section of the FDL file that 
describes keys. You must specify a separate KEY section for each key of an 
indexed file. The number of the key being described follows the word KEY 
(for example, KEY 0, KEY 1, . . . KEY n). The KEY value for the primary key 
must be 0. The KEY value for alternate keys can be numbered from 1 to 254. 

The KEY primary attribute corresponds to the XAB$B_REF field. 

Table FDL-7 lists the KEY secondary attributes and their default values. 


Table FDL-7 Default Values for KEY Secondaries 


Secondary 
CHANGES 
DATA_AREA 
DATA—FILL 

D ATA_KEY_COMPRESSION 

DATA_RECORD_COMPRESSION 

DUPLICATES 

INDEX_AREA 

INDEX_COMPRESSION 

INDEX-FILL 

LENGTH 

LEVEL 1—INDEX—AREA 
NAME 
NULL _KEY 
NULL-VALUE 


Default Value 

NO 

None 

Same as bucket size 

YES 

YES 

NO for primary; YES for alternate 

None 

YES 

Same as bucket size 

None 

None 

Null-string 

NO 

ASCII null character 
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Table FDL-7 (Cont.) Default Values for KEY Secondaries 


Secondary 

Default Value 

POSITION 

None 

PROLOG 

System or process default 

SEGn_LENGTH 

None 

SEGn_POSITION 

None 

TYPE 

STRING 


CHANGES 

Is a switch. When set to YES, it allows an RMS Update operation to change 
the value of the key. Such a change is not allowed for the primary key 
(regardless of this attribute), so the default setting for primary keys is NO. 
With alternate keys the default setting is also NO, but you can specify YES to 
allow changes to alternate key values. 

This attribute corresponds to the XAB$B—FLG field, the CHG option. 

DATA_AREA 

Identifies the area in which you will place the data records in an indexed file 
with multiple areas. The value is an integer in the range of 0 to 254, which 
must be the same number as that assigned to the area in an AREA section. 

The DATA_AREA, LEVEL1—INDEX —AREA, and INDEX-AREA values are 
used when the data level and the index levels are placed in separate areas, or 
when each key is placed in its own area. 

This attribute corresponds to the XAB$B_DAN field. 

DATA-FILL 

Sets the percentage of bytes in each data bucket in this area that you wish 
populated initially. If you anticipate that many records will be inserted 
randomly into the file, this value should be less than 100% of the bytes. The 
default value is 100% and the minimum value is 50%. The /FILL—BUCKETS 
qualifier to the CONVERT command will override this attribute. 

This attribute corresponds to the XAB$W_DFL field. Note that XAB$W_DFL 
contains a byte count, not a percentage. 

DATA—KEY—COMPRESSION 

Is a switch that controls whether leading and trailing repeating characters in 
the primary key will be compressed. The default is YES. For compression 
to occur, your indexed file must be defined as a Prolog 3 file with the FDL 
attribute KEY PROLOG. However, KEY PROLOG 3 is the default. 

This attribute should be set for DECnet operations. 

This attribute corresponds to the XAB$B_FLG field, the KEY—NCMPR option. 


DATA—RECORD—COMPRESSION 

Is a switch that controls whether repeating characters are compressed in the 
data records. The default is YES. For compression to occur, your indexed 
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file must be defined as a Prolog 3 file with the FDL attribute KEY PROLOG. 
However, KEY PROLOG 3 is the default. 

This attribute should be set for DECnet operations. 

This attribute corresponds to the XAB$B_FLG field, the DAT__NCMPR option. 


DUPLICATES 

Is a switch that controls whether duplicate keys are allowed in the indexed 
files. For primary keys the default setting is NO, but for alternate keys the 
default setting is YES. When the switch is set to YES, this attribute specifies 
that there can be more than one record with the same specific key value. 

Duplicate alternate keys can be useful. For example, sorting a customer file 
on an alternate key of the zip code is a common application, and is one that 
requires duplicate keys. Sorting a file on an alternate key of gender (male or 
female) is also an application that requires duplicate keys. 

When this attribute is set to NO, duplicate keys are not allowed, and any 
attempt to write a record where the key would be a duplicate will result in an 
error. 

This attribute corresponds to the XAB$B_FLG field, the DUP option. 

INDEX-AREA 

Identifies the area in which you will place the index levels other than level 1 
in an indexed file with multiple areas. The value is an integer in the range of 
0 to 254, which must be the same number as that assigned to the area in an 
AREA section. 

The INDEX—AREA, DATA-AREA, and LEVE LI-INDEX-AREA values are 
used when the data level and the index levels are placed in separate areas, or 
when each key is placed in its own area. 

This attribute corresponds to the XAB$B_IAN field. 

INDEX-COMPRESSION 

Is a switch that controls whether leading repeating characters in the index 
are compressed. The default value is YES. For compression to occur, your 
indexed file must be defined as a Prolog 3 file with the FDL attribute KEY 
PROLOG. However, KEY PROLOG 3 is the default. 

This attribute should be set for DECnet operations. 

This attribute corresponds to the XAB$B_FLG field, the IDX_NCMPR option. 


INDEX-FILL 

Sets the percentage of bytes in each index level bucket to be populated 
initially. If you anticipate that many records will be inserted randomly into 
the file, this value should be less than 100%. The default value is 100% and 
the minimum value is 50%. 

The /FILL— BUCKETS qualifier to the CONVERT command will override this 
attribute. 

This attribute corresponds to the XAB$W_IFL field, which is a byte count not 
a percentage. 
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LENGTH 

Sets the length of the key in bytes. This value, along with the POSITION 
and TYPE attributes, is used when the key is unsegmented. 

This value must be specified; there is no default. 

This attribute corresponds to the XAB$B_SIZO field. 

LEVEL1—INDEX _AREA 

Identifies the area in which you will place the level 1 index in an indexed file 
with multiple areas. The value is an integer in the range of 0 to 254, which 
must be the same number as that assigned to the area in an AREA section. 

The LEVEL1—INDEX —AREA, DATA-AREA, and INDEX-AREA values are 
used when the data level and the index levels are placed in separate areas, or 
when each key is placed in its own area. 

This attribute corresponds to the XAB$B_LAN field. 

NAME 

Assigns a name to a key. The value is a string from 1 to 32 characters long. 
This is an optional value; the default is no name (blank). The string is padded 
with ASCII null characters to 32 bytes. 

This attribute corresponds to the XAB$L_KNM field. 

NULL-KEY 

Controls whether null key values will be allowed in an alternate key field. 
The value of this attribute is a switch, set to NO by default. When set to NO, 
it means that all records must contain a valid value for this alternate key. 

In some databases such entries are not desirable; some records will not 
contain a value for a particular alternate key. By allowing null keys, declaring 
a null field, and writing the null field as the alternate key for a record, you 
can include the record in the database. 

When set to YES, this attribute means that null key values are allowed in the 
specified alternate index field of a record. 

A null key value is whatever you set it to be with the KEY NULL—VALUE 
secondary. If a record has the specified null value in its alternate key field, a 
pathway to that record will not be made in the alternate index structure. 

This attribute corresponds to the XAB$B_FLG field, the NUL option. 

NULL-VALUE 

Defines the null value that will instruct the system not to create an alternate 
index entry for the record that has the null value in every byte of the key 
field. 

If the alternate key is of the STRING type, you can specify the null value 
by either specifying the character itself or by specifying an unsigned decimal 
number denoting the character's ASCII value. To specify the character, 
enclose it in apostrophes. To specify the decimal ASCII value, just type it 
with no enclosing characters. 

The default is the ASCII null character (which is 0). 

This attribute corresponds to the XAB$B_NUL field. 
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POSITION 

Defines the byte position of the beginning of the key field within the record. 
The first position is 0. Primary keys work best if they start at byte 0. This 
attribute, along with the LENGTH and TYPE attributes, is used when the key 
is unsegmented. 

This attribute corresponds to the XAB$W_POSO field. 

PROLOG 

Defines the internal structure level of an indexed file. There are three different 
structure levels—Prolog 1, Prolog 2, and Prolog 3. 

Prolog 3 files accept multiple keys (or alternate keys) and all data types. 

They also give you the option of compressing your data, indexes, and keys. 
PROLOG 3 is the default. 

On the other hand, Prolog 1 and 2 files do not allow these options. You 
should not specify Prolog 3 if the primary key is segmented and the segments 
overlap. If you want to use a Prolog 3 file in this case, consider defining the 
overlapping segmented key as an alternate key and then choosing a different 
key to be the primary key. 

Note that neither RMS-11 Version 1.8 nor RMS-11 Version 2.0 supports 
Prolog 3 files. 

To specify a Prolog 3 file, assign the value 3 to this attribute. To specify a 
Prolog 1 or 2 file, assign the value 2. There is no difference between Prolog 1 
and Prolog 2 that you can perceive. 

If you do not specify a value for this attribute, then the utility that creates a 
data file from the FDL file will use the system or process default. To see these 
default values, give the DCL command SHOW RMS—DEFAULT. 

This attribute is not supported for DECnet operations; the default prolog in 
effect at the remote node is used. 

This attribute corresponds to the XAB$B_PROLOG field. 

SEGn_LENGTH 

Defines the length of the key segment in bytes. This attribute is used with 
the SEGn_POSITION attribute when the key is segmented. The n is the 
number of the segment and may be 0 to 7. The first segment in the key must 
be numbered 0, and each key may have up to eight segments. Segmented 
keys must be STRING type. 

For Prolog 3 files, segments may not overlap. 

This attribute corresponds to the field(s) from XAB$B_SIZ0 to XAB$B_SIZ7. 

SEGn_POSITION 

Defines the key segment's starting byte position within the record. The first 
position is 0. Segmented keys must be STRING type. 

For Prolog 3 files, segments may not overlap. 

This attribute corresponds to the XAB$W_POSO (through XAB$W_POS7) 
field(s). 
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TYPE 

The TYPE attribute specifies the type of the key. The value must be one of 
the following arguments: 

BIN2 Is an unsigned 2-byte binary number in the range of 0 to 65,535 


BIN4 

(2 8 -1). 

Is an unsigned 4-byte binary number in the range of 0 to 
4,294,967,295 (2 16 -1). 

BIN8 

DBIN2 

Is an unsigned, 8-byte binary value that ranges from 0 to 2 64 -1. 

Is an unsigned, 2-byte binary value that ranges from 0 to 65,535 
(2 8 -1). In an indexed file, records are stored in descending order for 
this key of reference. 

DBIN4 

Is an unsigned, 4-byte binary value that ranges from 0 to 
4,294,967,295 (2 16 -1). In an indexed file, records are stored in 
descending order for this key of reference. 

DBIN8 

Is an unsigned, 8-byte binary value that ranges from 0 to 2 64 -1. In 
an indexed file, records are stored in descending order for this key of 
reference. 

DDECIMAL 

Is a packed decimal value, a continuous string of between 1 and 16 
bytes, that is accessed in descending sort order in an indexed file. 
The format of the DDECIMAL type is the same as for DECIMAL, as 
described below (except that DECIMAL is accessed in ascending 
order). 

DECIMAL 

Is a packed decimal value, which is a continuous string of from 1 to 
16 bytes. A DECIMAL value is specified by the address of the first 
byte of the string, and by the number of decimal digits. 

Each byte in a DECIMAL value is divided into two 4-bit fields. Each 
of these fields contains the binary representation of one decimal digit, 
except for the first 4-bit field in the highest byte, which represents 
the sign of the DECIMAL value. 

Although four bits can represent values up to decimal 16 (a 
hexadecimal 10), values greater than 9 are not allowed in a DECIMAL 
4-bit field, except for the sign field. 

The byte with address A contains the two beginning digits of the 
value. The high-order 4-bit field contains either the most significant 
digit or a leading zero if it is needed to make the sign field appear in 
the correct 4-bit field. 

DINT2 

For example, a DECIMAL value of +123 with address A has a length 
of 3 (for 3 digits) and requires 2 bytes of storage. 

A DECIMAL value of -5237 at address B would have a length of 4 
digits. It would need three bytes of storage. 

Is a signed 2-byte integer that is accessed in descending order in an 
indexed file. This data type can represent integers between -32,768 
and +32,767. 

DINT4 

Is a signed 4-byte integer that is accessed in descending order 
in an indexed file. This data type can represent integers between 
-2,147,483,648 and +2,147,483,647. 
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DINT8 

Is a signed 8-byte integer that is accessed in descending order in an 
indexed file. This data type can represent integers between -2 63 and 
+2 63 -1. 

DSTRING 

Is a string of ASCII characters that are accessed in descending sort 
order in an indexed file. The maximum length of the string is 255 
characters. 

INT2 

Is a signed 2-byte integer; this data type can represent integers 
between -32,768 and +32,767. 

INT4 

Is a signed 4-byte integer; this data type can represent integers 
between -2,147,483,648 and +2,147,483,647. 

INT8 

Is a signed 8-byte integer; this data type can represent integers 
between -2 63 and +2 63 -1. 

STRING 

Is a string of ASCII characters. The longest length allowed is 255 
characters. 


STRING is the default key data type. 

This attribute corresponds to the XAB$B_DTP field. 


1.1.9 RECORD Section 

The RECORD section contains secondary attributes that define records. The 
RECORD keyword itself takes no value; it serves only to begin this section. 
Table FDL-8 lists the RECORD secondary attributes and their default values. 


Table FDL-8 Default Values for RECORD Secondaries 


Secondary 

Default Value 

BLOCK_SPAN 

YES 

CARRIAGE-CONTROL 

CARRIAGE-RETURN 

CONTROL—FIELD 

2 

FORMAT 

VARIABLE 

SIZE 

No default 


BLOCK_SPAN 

Is a switch, set by default to YES. It determines whether records can span 
block boundaries in a sequential file. When the switch is set to YES, records 
can span block boundaries. 

When the switch is set to NO, records cannot span block boundaries; in other 
words, they cannot be larger than 512 bytes. However, if the records are 
smaller than 512 bytes, VAX RMS stores as many records as possible in a 
block until the space remaining is smaller than the next record size. The next 
record, then, is stored in a new block. 

This attribute corresponds to the FAB$B_RAT field, the BLK option. 
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CARRIAGE_CONTROL 

Must be one of the following keywords: 

CARRIAGE_RETURN Is the default. It specifies that each record is preceded by 
a line feed and is followed by a carriage return when the 
record is written to a carriage control device, such as a 
line printer or a terminal. 

FORTRAN Specifies that the first byte (byte 0) of each record 

contains a FORTRAN (ASA) carriage control character. 
The following table lists the byte 0 values and the control 
characters that they represent. 


Byte 0 Value 

ASCII 

Character 

Meaning 

0 

null 

Null carriage control. Sequence: print buffer 
contents. 

20 

space 

Single-space carriage control. Sequence: line 
feed, print buffer contents, carriage return. 

30 

0 

Double-space carriage control. Sequence: line 
feed, line feed, print buffer contents, carriage 
return. 

31 

1 

Page eject carriage control. Sequence: form 
feed, print buffer contents, carriage return. 

28 

+ 

Overprint carriage control. Sequence: print 
buffer contents, carriage return. Allows double 
printing for emphasis. 

24 

$ 

Prompt carriage control. Sequence: line feed, 
print buffer contents. 

All others 


Same as ASCII space character: single-space 
carriage control. 


NONE Specifies that no carriage control is to be provided. 

PRINT Specifies that the carriage control information will come 

from the fixed control portion of a variable with fixed 
control (VFC) record. The first byte of the fixed control 
portion specifies the carriage control to be performed 
before printing. The second byte specifies the type of 
carriage control to be performed after printing. 

The following tables show the encoding scheme of both 
bytes. 
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Bit 7 

Bits 0-6 

Meaning 

0 

0 

No carriage control is specified, that is, NULL. 

0 

1 

Bits 0 through 6 are a count of new lines—a line feed 
followed by a carriage return. 


Bit 7 

Bit 6 

Bit 5 

Bit 0-4 

Meaning 

1 

0 

0 

0-1F 

Output the single ASCII control 
character specified by the configuration 
of bits 0 through 4 (7-bit character set). 

1 

1 

0 

0-1F 

Output the single ASCII control 
character specified by the configuration 
of bits 0 through 4. The five bits are 
translated as ASCII characters 128 
through 159 (8-bit character set). 

1 

1 

1 

0-1F 

Reserved. 


This attribute corresponds to the FAB$B_RAT parameter. 

CONTROI_FIELD 

Specifies the size in bytes of the fixed control portion of VFC records. Its 
value must be a number in the range of 1 to 255. The default is 2. 

This attribute corresponds to the FAB$B_FSZ field. 


FORMAT 

Sets the record format for the data file. Its value must be one of the following 
keywords: 


FIXED 

STREAM 


STREAM_CR 

STREAM_LF 

UNDEFINED 

VARIABLE 

VFC 


Specifies fixed-length records. 

Specifies that the records are STREAM records; the record is 
viewed as a continuous stream of bytes, delimited by a special 
character. This format is compatible with RMS-11 stream files. 
This is valid for sequential files only. 

Specifies that the records are STREAM records; the record is 
viewed as a continuous stream of bytes, delimited by a CR 
character. This is valid for sequential files only. 

Specifies that the records are STREAM records; the record is 
viewed as a continuous stream of bytes, delimited by an LF 
character. This is valid for sequential files only. 

Specifies undefined record format, which means that the record 
is a continuous stream of bytes with no specific terminator. 
This keyword is valid for sequential files only. 

Specifies variable-length records. This is the default setting. 

Specifies variable with fixed control records. This is valid for 
sequential and relative files. 


This attribute corresponds to the FAB$B_RFM field. 

SIZE 

Sets the maximum record size in bytes. 

When used with fixed-length records, this value is the length of every record 
in the file. 
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When used with variable-length records, this value is the longest record that 
can be placed in the file. With sequential or indexed files, you can specify 0 
and the system will not impose a maximum record length. (Note, however, 
that records in an indexed or relative file cannot cross bucket boundaries.) 

When used with relative files, the SIZE attribute is used with the 
BUCKET_SIZE attribute to set the size of the fixed-length cells. 

With VFC records, do not include the fixed control portion of the record in the 
SIZE calculation; only the data portion is set by this attribute. The RECORD 
CONTROL—FIELD attribute sets the size of the fixed control portion. 

The fixed area is the size in bytes of the fixed-control portion of VFC records. 
Regular variable-length records have a fixed-control size of 0. 

This attribute corresponds to the FAB$W_MRS field. 

Table FDL-9 gives the maximum record sizes in bytes for the various record 
organizations and record formats. 


Table FDL-9 Maximum Record Size for File Organizations and 


Record Formats 

File Organization 

Record Format 

Maximum Record Size 

Sequential 

Fixed-length 

32,767 

Sequential (disk) 

Variable-length 

32,767 

Sequential (disk) 

VFC 

32,767-FSZ 1 

Sequential (disk) 

Stream 

32,767 

Sequential (disk) 

Stream CR 

32,767 

Sequential (disk) 

Stream LF 

32,767 

Sequential (ANSI Tape) 

Variable-length 

9,995 

Sequential (ANSI Tape) 

VFC 

9,995-FSZ 1 

Relative 

Fixed-length 

32,255 

Relative 

Variable-length 

32,253 

Relative 

VFC 

32,253-FSZ 1 

Indexed, Prolog 1 or 2 

Fixed-length 

32,234 

Indexed, Prolog 1 or 2 

Variable-length 

32,232 

Indexed, Prolog 3 

Fixed-length 

32,224 

Indexed, Prolog 3 

Variable-length 

32,224 


^he FSZ represents the size of the fixed control area of a record for the variable 
with fixed-control (VFC) record format. The FSZ is equal to the size, in bytes, for 
the fixed control area of VFC records. 

The length of the largest record in a sequential file on a disk device with variable 
or VFC record format is also maintained by VAX RMS. 


For DECnet operations, the maximum record size is determined by the DCL 
command SET RMS/NETWORK-BLOCK—COUNT. 
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1.1.10 SHARING Section 

The SHARING section allows you to specify whether or not you want to 
allow multiple readers or writers to access your file at the same time. The 
SHARING keyword itself takes no values. Table FDL-10 lists the SHARING 
secondary attributes and their default values. 


Table FDL-10 Default Values for SHARING Secondaries 


Secondary 

Default Value 

DELETE 

None. 

GET 

GET if ACCESS GET has also been specified 

MULTISTREAM 

None. 

PROHIBIT 

None. 

PUT 

None. 

UPDATE 

None. 

USER_INTERLOCK 

None. 


DELETE 

Is a switch allowing other users to delete records from the file. 

This attribute corresponds to the FAB$B_SHR field, the DEL option. 

GET 

Is a switch allowing other users to read the file (to perform Find or Get 
RMS services or the equivalent VAX language statement that reads a record). 
SHARING GET is the default if you have also specified ACCESS GET. 

This attribute corresponds to the FAB$B_SHR field, the GET option. 

MULTISTREAM 

Is a switch allowing multistream access and is relevant for record operations 
only. This attribute is not available for sequential files with other than 
512-byte fixed-length records. 

This attribute is not supported for DECnet operations; an error is returned if 
you try to use it. 

This attribute corresponds to the FAB$B__SHR field, the MSE option. 

PROHIBIT 

Is a switch prohibiting any type of file sharing by other users. If you specify 
YES, PROHIBIT takes precedence over all other ACCESS secondaries. If you 
specify the DELETE, PUT, TRUNCATE, or UPDATE attribute in the ACCESS 
section, the PROHIBIT attribute defaults to YES. 

This attribute corresponds to the FAB$B_SHR field, the NIL option. 

PUT 

Is a switch allowing other users to write records to the file (to perform Put or 
Extend RMS services or the equivalent VAX language statement that writes a 
record or extends the space allocated to a file). 

This attribute corresponds to the FAB$B_SHR field, the PUT option. 
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UPDATE 

Is a switch allowing other users to update records that currently exist in 
the file (to perform Update or Extend RMS services or the equivalent VAX 
language statement that rewrites a record or extends the space allocated to a 
file). 

This attribute corresponds to the FAB$B_SHR field, the UPD option. 

USER_INTERLOCK 

Is a switch allowing one or more users to write to a sequential file or a shared 
file. Usually, this attribute is used for a file that is open for block I/O. You 
must be responsible for any interlocking required. USER—INTERLOCK is 
specified with the DELETE, GET, PUT, and UPDATE attributes. 

This attribute corresponds to the FAB$B_SHR field, the UPI option. 


1.1.11 SYSTEM Section 

The SYSTEM section consists of system identification information. The 
SYSTEM primary keyword takes no value. It may be used to help document 
your FDL file. Table FDL-11 lists the SYSTEM secondary attributes and their 
default values. 


Table FDL-11 Default Values for SYSTEM Secondaries 


Secondary 

Default Value 

DEVICE 

Null-string 

SOURCE 

VAX/VMS 

TARGET 

VAX/VMS 

DEVICE 


Takes a string value that is used for comment purposes only. The intended 
use is to name the model of the disk on which the data file will reside, for 
example, RP06 or RM03. 


SOURCE 

Is the name of the operating system that you are using to create the FDL file. 
The value must be one of the following keywords: 

• IAS 

• RSTS/E 

• RSX-11M 

• RSX-11M-PLUS 

• RT-11 

• VAX/VMS 

TARGET 

Is the name of the operating system on which the FDL file will be used. The 
value must be one of the following keywords: 

• IAS 

• RSTS/E 

• RSX-11M 
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• RSX-l 1M-PLUS 

• RT-11 

• VAX/VMS 


1.1.12 TITLE and IDENT Attributes 

If you use EDIT/FDL to create your FDL file, the utility will prompt you 
for a title during the session. The title is a string that you can place at 
the beginning of the FDL file. The character string that you supply is for 
comment purposes only. It can be up to 132 characters long, including the 
TITLE keyword. 

When the Edit/FDL and Analyze/RMS_File utilities create an FDL file, they 
place a header in the FDL file after the TITLE called the IDENT section. The 
IDENT section contains the date and time of the creation of the FDL file, 
and it specifies the name of the utility that created it (either EDIT/FDL or 
ANALYZE/RMS—FILE). 

However, you can also specify the header in the IDENT section. The 
character string that you supply can be up to 132 characters long, including 
the IDENT keyword. 


2 Creating FDL Files 

FDL is a powerful tool that can help you easily create the data files for which 
you have defined specifications. However, you must first create an FDL file 
containing these specifications. You can create FDL files with one of four 
methods below: 

• Edit/FDL Utility 

• Analyze/RMS_File Utility 

• Text editor 

• DCL CREATE command 

One way to create FDL files easily is with the Edit/FDL Utility (also known 
as the FDL Editor). You can use EDIT/FDL to design FDL files that define 
commonly needed data files, and then create the data files when they are 
needed. EDIT/FDL has some special features that simplify the process of 
creating an FDL file. It recognizes FDL syntax and informs you of syntax 
errors immediately. It also allows you to model the data file to be created and 
to change attribute values to find the most efficient design. EDIT/FDL gives 
files the file type FDL by default. 

In addition, the Analyze/RMS_File Utility can create an FDL file from 
an existing data file. The FDL file can then be used with the EDIT/FDL 
Optimize script to determine the optimum design of the data file. 

You can also use the VAX/VMS text editors or the DCL command CREATE 
to create text files containing FDL specifications. Using the text editors or 
CREATE is not recommended because you must make sure that you place 
the primary sections in the correct order and that you give valid values to the 
attributes. For more information on validity rules, refer to Section 2.1. 
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Below is an example of a completed FDL file. 


TITLE Sequential organization, variable records up to 320 bytes 

IDENT 24-JUN-1983 13:08:17 VAX-11 FDL Editor 

SYSTEM 


SOURCE 


VAX/VMS 


FILE 


ALLOCATION 

BEST.TRY.CONTIGUOUS 

EXTENSION 

ORGANIZATION 


5050 

yes 

505 


sequential 


RECORD 


BLOCK.SPAN 

CARRIAGE.CONTROL 

FORMAT 

SIZE 


yes 

carriage_return 

variable 

320 


2.1 Validity Rules 


The Edit/FDL and Analyze/RMS_File utilities place the attributes in their 

correct format and order automatically. If you use the CREATE command or a 

text editor to create an FDL file, you must observe the validity rules described 

below. 

• The primary sections must appear in the order listed in Section 1.1. If you 
have two or more AREA primary sections, they must follow one another 
in numerical order (for example, AREA 1, AREA 2, . . . ,AREA n). 

• If you have two or more KEY primary sections, they too must follow one 
another in numerical order (for example, KEY 0, KEY 1, . . . ,KEY n). 

• Within a KEY primary, any SEGn secondaries should follow one another 
in numerical order; the SEGn numbers must be "dense," not "sparse." For 
example, if you use SEG3 to label a key segment, segments SEGO, SEG1, 
and SEG2 must also exist. 

• Each source line can contain exactly one primary or secondary attribute, 
along with its associated value. Each source line may have no more than 
132 characters. 

• To begin a comment, use the exclamation point. Comments begin at the 
exclamation point and continue to the end of the line. 

• EDIT/FDL ignores leading or trailing blanks or tabs. 

• FDL string values are terminated by the comment character (!) or the 
statement terminator (;). Strings must be quoted. 

• You may truncate keywords, but take care to avoid ambiguities. The 
Edit/FDL and Analyze/RMS_JFile utilities always write out the entire 
keyword. 
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3 Creating Data Files with RMS Utilities, Routines, and FDL Files 

Once you have created an FDL file, it can be used by the RMS utilities and 
callable utility routines to format data files according to your specifications. 
Specifically, the RMS utilities CREATE/FDL and CONVERT as well as the 
CONVERT and FDL callable utility routines use FDL files. In addition, EDIT 
/FDL can use an existing FDL file as an input to the Optimize script. 

CREATE/FDL uses the specifications in an existing FDL file to create a 
new, empty data file. You can either supply CREATE/FDL with the file 
specification of the new data file, or CREATE/FDL can use the specification 
given in the FDL file itself. 

The Convert Utility, on the other hand, uses the specifications in an FDL file 
to create an output data file and to load it with records from an input file or 
files. 

Like the Convert Utility, the Convert routines (CONV$CONVERT, 
CONV$PASS_FILES, and CONV$PASS_OPTIONS) use the specifications in 
FDL files to create output data files from within a program. 

These data files can use the full set of VAX RMS creation-time options. They 
can be used by all the native VAX high-level languages. This capability gives 
the high-level language user a tool for creating efficient data files that use a 
minimum amount of system resources. VAX MACRO and BLISS-32 programs 
can also use the data files. 

The FDL routines (FDL$CREATE, FDL$GENERATE, and FDL$PARSE) 
also use FDL files. FDL$CREATE invokes the functions of the Create/FDL 
Utility to create a file from an FDL specification and then close the file. 

FDL$ GENERATE produces an FDL specification from the RMS control blocks 
that your program supplies and then writes it to either an FDL file or a 
character string. FDL$PARSE parses an FDL specification, allocates RMS 
control blocks (FABs, RABs, or XABs), and then fills in the relevant fields. 
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CREATE/FDL 

COMMAND 

QUALIFIERS 


The Create/FDL Utility has only one command qualifier—the /LOG qualifier. 
It does not affect the execution of the utility; it only produces an informational 
message. 
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/LOG 

Controls whether the Create/FDL Utility displays the file specification 
of the data file that it has created. By default, the utility does not 
display the file specification. 

FORMAT 

/[NO]LOG 

qualifier values 

None. 


EXAMPLES 

Q $ CREATE/FDL=INVENTORY/LOG DISK$:[COMPANY.ORDERS]PARTS.DAT 
%FDL-I-CREATED, DISK!:[COMPANY.ORDERS]PARTS.DAT;1 CREATED 


This command produces the empty output file PARTS.DAT from the 
specifications in the FDL file INVENTORY.FDL. In addition, CREATE/FDL 
returns the message stating that the file was indeed created. 

2 $ CREATE/FDL*INVENTORY/NOLOG PARTS.DAT 

$ 

This command produces the empty output file PARTS.DAT from the 
specifications in the FDL file INVENTORY.FDL. No informational message is 
returned. 
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EDIT/FDL 

COMMAND 

QUALIFIERS 


The DCL command EDIT/FDL begins an interactive session during which 
you can create or modify an FDL file. You can give file design decisions to 
the FDL editor, and it will supply values for the FDL attributes; or you can 
assign values to the attributes yourself. 
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/ANALYSIS 



Indicates that an FDL file (which must have been generated by the 
Analyze/RMS_File Utility) is to be used in the Optimize script. 

FORMAT 

/ANALYSIS=fd/-f//e-spec 

qualifier value 

fdl-file-spec 

Specifies the particular FDL file (which must have been generated by the 
Analyze/RMS—Tile Utility) to be used in the Optimize script. The default is a 
null specification. 


EXAMPLE 

$ EDIT/FDL/ANALYSIS=Q1_SALES Q2_SAL.ES 

This command begins an interactive session in which the analysis information 
in the file Q1__SALES.FDL is used to optimize and then create the output file 
Q2—SALES.FDL. 
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/CREATE 

Allows you to create an output file without an existing input file. 

FORMAT 

/CREATE 

qualifier values 

None. 

DESCRIPTION 

With the /CREATE qualifier, you can create an output file that does not 
exist without receiving a message from EDIT/FDL stating that the file will 
be created. EDIT/FDL does not even try to open the specified file for input; 
when you use the /CREATE qualifier, EDIT/FDL knows the file does not 
exist (or that you want EDIT/FDL to ignore it). 

Clearly, you can only select the Design or the Add Key scripts when your 
input file does not already exist. 


EXAMPLE 

$ EDIT/FDL/CREATE SALES.DATA 

Begins a session in which SALES—DATA.FDL is created. EDIT/FDL does not 
issue the informational message stating that the new file SALES—DATA.FDL 
will be created. 
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/DISPLAY 

Specifies the type of graph you want displayed. 

FORMAT 

/ D1S P l_A Y=graph-op tion 

qualifier value 

graph-option 

Specifies the type of graph you want displayed. Legal graph options are as 
follows: 

LINE Plots bucket size against index depth 

FILL Plots bucket size by the percentage of load fill by index depth 

KEY Plots bucket size by key length by index depth 

RECORD Plots bucket size by record size by index depth 

INIT Plots bucket size by initial load record count by index depth 

ADD Plots bucket size by additional record count by index depth 

The default is LINE. 


EXAMPLE 

$ EDIT/FDL/DISPLAY=KEY TEMP.DATA 

This command begins an interactive session in which the default value 
for the type of graph to be displayed has been changed from LINE to the 
user-specified KEY. TEMP_DATA is the name of the FDL file to be created. 
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/EMPHASIS 



Allows you to choose between smaller buffers and flatter files. You 
can use this qualifier with the /NOINTERACTIVE qualifier if you want 
EDIT/FDL to be executed without an interactive terminal dialogue. 

FORMAT 

/EMPHASIS= tuning-bias 

qualifier value 

tuning-bias 

Represents how you want to weight the default bucket size for your file. 
There are two legal options: 

FLATTER_FILES Generally increases bucket size. The bucket size, in turn, 

controls the number of levels in the index structure. If a 
larger bucket size eliminates one level, then you should 
use this option. At some point, however, the benefit of 
having fewer levels will be offset by the cost of scanning 
through the larger buckets. 

SMALLER—BUFFERS Generally decreases the amount of memory you have to 
use. 

FLATTER_FILES is the default. It should be used unless excessive paging or 
RMS CPU time occurs due to oversized buffers. However, if your system has 
little extra memory or if you are not sure which tuning-bias will improve the 
performance of your program, try tuning your file using SMALLER—BUFFERS 
and then FLATTER-FILES. 


EXAMPLE 

$ EDIT/FDL/EMPHASIS=SMALLER_BUFFERS TEMP_DATA 

This command begins an interactive session in which the default value for 
the bucket size emphasis has been changed from FLATTER_FILES to the 
user-specified SMALLER—BUFFERS. TEMP_DATA is the name of the FDL 
file to be created. 
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/GRANULARITY 

Allows you to divide an indexed file into a specified number of 
areas. You can use this qualifier with the /NOINTERACTIVE qualifier 
if you want EDIT/FDL to be executed without an interactive terminal 
dialogue. 


FORMAT /GRANULARITY=n 


qualifier value n 

Indicates the number of areas into which you want to divide your indexed 
file. The default is three areas, as shown below. 


AREA 

CONTENTS 

0 

KEY 0 data 

1 

KEY 0 index 

2 

All other indexes 


EXAMPLE 

$ EDIT/FDL/GRANULARITY=1 TEMP.DATA 

This command begins an interactive session in which the default value for the 
number of areas in an indexed file has been changed from three areas to the 
one area. TEMP_DATA is the name of the FDL file to be created. 
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/NOINTERACTIVE 



Causes EDIT/FDL to execute the Optimize script without a terminal 
dialog. 

FORMAT 

/NOINTERACTIVE 

qualifier values 

None. 

DESCRIPTION 

The /NOINTERACTIVE qualifier allows you to optimize an existing FDL file 
with EDIT/FDL, but without an interactive terminal dialog. You must have 
previously issued the ANALYZE/RMS—FILE/FDL command, specifying your 
existing RMS data file as the target file. EDIT/FDL then uses the data from 
the analysis FDL file while the Optimize script proceeds noninteractively. 

If data is missing, EDIT/FDL uses the defaults. However, if certain critical 
data items cannot be found in the analysis file, EDIT/FDL terminates without 
producing an output file. 


EXAMPLE 

$ EDIT/FDL/ANALYSIS=TEMP_DATA/NOINTERACTIVE TEMP.DATA 

This command begins a non-interactive session in which the FDL file 
TEMP_DATA;2 is created from the analysis FDL file TEMP.DATA;!. 
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/NUMBER_KEYS 

Allows you to specify the number of keys in your indexed file. 


FORMAT /NUMBER_KEYS=n 


qualifier value n 

Indicates how many keys you want to define for your indexed file. You can 
define up to 255 keys. The default is one key. 


EXAMPLE 

$ EDIT/FDL/NUMBER_KEYS=3 TEMP.DATA 

This command begins an interactive session in which the default value 
for the number of keys in an indexed file is changed from one key to the 
user-specified three keys. TEMP_DATA is the name of the FDL file to be 
created. 
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/OUTPUT 

Specifies the FDL file in which to place the definition from this 
session. 

FORMAT 

/ 0\JTPUT= fdl-file-spec 

qualifier value 

fdl-file-spec 

Specifies the output FDL file. 

DESCRIPTION 

If you omit the /OUTPUT qualifier, then the output FDL file will have the 
same name and file type as the input file, with a version number that is one 
higher than the highest existing version of the file. 

The default file type is FDL. 

EXAMPLE 


$ EDIT/FDL/OUTPUT=NEWINDEX INDEX 

Begins a session in which the contents of INDEX.FDL are read into the FDL 
editor and can then be modified. NEWINDEX.FDL is created; INDEX.FDL is 
not changed. 
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/PROMPTING 



Specifies the level of prompting to be used during the terminal 
session. 

FORMAT 

/PROM PTI NG=prompt-option 

qualifier value 

prompt-option 

Specifies the level of menu prompting to be used during the terminal session. 
Legal prompt options are defined below. 

BRIEF Selects a terse level of prompting 

FULL Provides more information about each menu question 

By default, EDIT/FDL chooses either BRIEF or FULL, depending on the 
terminal type and the line speed. High-speed CRT terminals will get FULL; 
nonscope terminals and terminals operating at less than 2400 baud will get 
BRIEF. 

If EDIT/FDL has to repeat a question, it repeats the FULL version of the 
question, with a BRIEF form of the HELP text. You can also type ? for help 
on a particular question. 

The extra line of HELP text is not given for menu questions, however. 


EXAMPLE 

$ EDIT/FDL/PROMPTING=BRIEF TEMP_DATA 

This command begins an interactive session in which the value of the 
prompting level for the EDIT/FDL menus is set to BRIEF. 
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/RESPONSES 



Allows you to select how you want to respond to script questions. 

FORMAT 

/RESPONSES=response-option 

qualifier value 

response-option 

Specifies the type of script response you want to use. The two legal options 
are described below. 

AUTOMATIC Indicates that you automatically want all script default responses 
to be used. This option speeds the progress of the question and 
answer session. Once you have entered the design phase, you 
can modify most of the answers you took by default. 

MANUAL Indicates that you want to provide all script responses. No default 

responses are automatically used. 

If you use the SET RESPONSES function, AUTOMATIC is the default. For 
EDIT/FDL, however, MANUAL is the default. 


EXAMPLE 

$ EDIT/FDL/RESPONSES=MANUAL TEMP.DATA 

This command begins an interactive session in which the default value for 
type of script response is changed from AUTOMATIC to the user-specified 
MANUAL. 
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/SCRIPT 




Controls whether EDIT/FDL will begin the session by asking a 
logically grouped sequence of questions to aid you in creating the 
FDL file. 

FORMAT 

/SC R 1 PT =script-title 

qualifier value 

script-title 

Identifies the seven valid script titles. The legal options are defined below. 


ADD_KEY 

Allows you to model or add to the attributes of a new index. 


DELETE_KEY 

Allows you to remove attributes from the highest index of your 
file. 


INDEXED 

Begins a dialogue in which you are prompted for information 
about the indexed data file to be created from the FDL file. EDIT 
/FDL will supply values for certain attributes. 


OPTIMIZE 

Requires that you use the analysis information from an FDL file 
that was created with the Analyze/RMS_File Utility. The FDL file 
itself is one of the inputs to the Edit/FDL Utility. In other words, 
you may tune the parameters of all your indexes using the file 
statistics from ANALYZE/RMS—FILE. 


RELATIVE 

Begins a dialogue in which you are prompted for information 
about the relative data file to be created from the FDL file. EDIT 
/FDL will supply values for certain attributes. 


SEQUENTIAL 

Begins a dialogue in which you are prompted for information 
about the sequential data file to be created from the FDL file. 
EDIT/FDL will supply values for certain attributes. 


TOUCHUP 

Begins a dialogue in which you are prompted for information 
about the changes you wish to make to an existing index. 

DESCRIPTION 

The default is not to invoke a script automatically. Note that if you specify 
/NOSCRIPT you can still use the scripts by giving the INVOKE command in 
response to the main editor function prompt. 


EXAMPLE 


$ EDIT/FDL/SCRIPT=INDEXED TEMP.DATA 

This command begins an interactive session in which the both the main menu 
and the script menu are bypassed. Instead, the Indexed script is generated 
immediately. 
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EDIT/FDL 

COMMANDS 


The EDIT/FDL commands are used during the interactive session only. EDIT 
/FDL prompts for one of these commands at the start of your interactive 
session. 


The command line prompt consists of a short question, the type of required 
value (in parentheses), and the default answer (in brackets). 

However, because EDIT/FDL is not command oriented but menu oriented, 
the prompt may change during the interactive session to fit the needs of the 
menu questions. In general, the prompt consists of a short question, the type 
of required value or the range of acceptable values (in parentheses), and the 
default answer (in brackets), as follows: 

question (keyword or range)[default] : answer 

In addition, some prompts consist of a short question, a list or a range of 
acceptable values (either in parentheses or in a table), the required type of the 
value (in parentheses), and the default answer (in brackets), as follows: 

(list of values) 

question (keyword or range)[default] : answer 

If no default is allowed, you see the symbol [-]. In this case, you must supply 
an answer. 
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ADD 

Allows you to add one or more lines to the FDL file. 

FORMAT 

ADD 

command 

parameters 

None. 

command 

qualifiers 

None. 


EXAMPLE 


Main Editor Function 

(Keyword)[Help] : ADD 

This command allows you to add lines to your existing FDL file. When you 
issue the ADD commmand, EDIT/FDL prompts you with another menu: 

Legal Primary Attributes 

ACCESS attributes set the run-time access mode of the file 

ACL entries specify the Access-Control-List of the file 

AREA x attributes define the characteristics of file area x 

CONNECT attributes set various RMS run-time options 

DATE attributes set the date parameters of the file 

FILE attributes affect the entire RMS data file 

JOURNAL attributes set the journaling parameters of the file 

KEY y attributes define the characteristics of key y 

RECORD attributes set the non-key aspects of each record 

SHARING attributes set the run-time sharing mode of the file 

SYSTEM attributes document operating system-specific items 

TITLE is the header line for the FDL file 

Enter desired primary (Keyword)[FILE] : 

After you type the name of the primary attribute, EDIT/FDL provides another 
menu showing all the secondary attributes for that primary, and asks which 
secondary's value you want to change. 
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DELETE 

Allows you to delete one or more lines from the FDL file. 

FORMAT 

DELETE 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 


Main Editor Function 

(Keyword)[Help] : DELETE 

This command allows you to delete lines from your existing FDL file. When 
you issue the DELETE commmand, EDIT/FDL prompts you with menu 
displaying the current primary attributes of your FDL file. After you type in 
the name of a primary attribute, EDIT/FDL prompts you with another menu 
displaying the current secondary attributes for that primary, and asks which 
secondary's value you want to change. 
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EXIT 

Ends the EDIT/FDL session. The EXIT command causes the new 
FDL file to be created. This command is equivalent to issuing 
CTRL/Z. 

FORMAT 

EXIT 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 


Main Editor Function 

(Keyword)[Help] : EXIT 

This command allows you to leave EDIT/FDL after creating or modifying 
your FDL file. It displays the file specification of the FDL file it has created or 
modified and then returns you to DCL command level. 
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HELP 

Invokes a help session about the EDIT/FDL commands and the File 
Definition Language on the screen. 

FORMAT 

HELP 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 


Main Editor Function 

(Keyword)[Help] : HELP 

This command allows you to ask for information about EDIT/FDL while you 
are editing your FDL file. It displays a menu of the various topics on which 
you can ask for help, as follows: 

Information available: 

Abstract Add Delete Exit Help Invoke Modify 

Operation Quit Set View 

Topic? 
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INVOKE 


INVOKE 

Prompts for your choice of scripts and initiates your choice. The 
scripts guide you through the design and optimization of a data file. 

FORMAT 

INVOKE 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 


Main Editor Function 

(Keyword)[Help] : INVOKE 

This command allows you to select which script you want to help you design 
your FDL file. After you type the INVOKE command, EDIT/FDL prompts 
you with another menu displaying the possible script choices: 

Script Title Selection 

Add.key modeling and addition of a new index's parameters 

Delete_key removal of the highest index's parameters 

Indexed modeling of parameters for an entire Indexed file 

Optimize tuning of all indices' parameters using file 

statistics 

Relative selection of parameters for a Relative file 

Sequential selection of parameters for a Sequential file 

Touchup remodeling of parameters for a particular index 

Editing Script Title (Keyword)[-] : 
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MODIFY 


MODIFY 

Allows you to change an existing line in the FDL definition. 

FORMAT 

MODIFY 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 


Main Editor Function 

(Keyword) [Help] : MODIFY 

This command allows you to modify lines in your existing FDL file. When 
you issue the MODIFY command, EDIT/FDL prompts you with menu 
displaying the current primary attributes of your FDL file. After you type in 
the name of a primary attribute, EDIT/FDL prompts you with another menu 
displaying the current secondary attributes for that primary, and asks which 
secondary's value you want to change. 
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File Definition Language 

QUIT 


QUIT 

Causes an abrupt end to the EDIT/FDL session. The new FDL file is 
not created. The QUIT command is equivalent to issuing CTRL/C. 

FORMAT 

QUIT 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 


Main Editor Function 

(Keyword)[Help] : QUIT 

This command abruptly returns yoi to the DCL command level without 
creating or modifying an FDL file. 
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SET 


SET 

Allows you to establish defaults or to select any of the FDL editor 
characteristics you forgot to specify on the command line. 

FORMAT 

SET 

command 

parameters 

command 

qualifiers 

None. 

None. 


EXAMPLE 


Main Editor Function 

(Keyword)[Help] : SET 

This command allows you to establish defaults and to reduce the number of 
questions you are asked by the scripts. After you type the SET command, 
EDIT/FDL displays the following menu: 

FDL Editor SET Function 

ANALYSIS filespec of FDL Analysis file 

DISPLAY type of graph to display 

EMPHASIS of default bucketsize calculations 

GRANULARITY number of areas in Indexed files 

NUMBER.KEYS number of keys in Indexed files 

OUTPUT filespec of FDL output file 

PROMPTING Full of Brief prompting of menus 

RESPONSES usage of default reponses in scripts 

Editor characteristic to set (Keyword)[-] 
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VIEW 


VIEW 

Displays the attributes contained in the current FDL definition. 

FORMAT 

VIEW 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 


Main Editor Function 

(Keyword)[Help] : VIEW 

This command displays your current FDL file a screen at a time. 
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File Definition Language 

Examples 


FDL 

EXAMPLES 

□ $ EDIT/FDL INDEX 


This command begins an interactive session that will modify an FDL file 
named INDEX.FDL. 

0 $ EDIT/FDL/ANALYSIS=INDEXFILE/SCRIPT=OPTIMIZE MAKEINDEX 

This command uses the analysis information in INDEXFILE.FDL to create a 
more efficient MAKEINDEX.FDL. The sequence of events is as follows: 

1 FDL file MAKEINDEX.FDL created with EDIT/FDL 

2 INDEXFILE.DAT created with CREATE/FDL=MAKEINDEX command 

3 INDEXFILE.DAT used in applications 

4 INDEXFILE.FDL created with ANALYZE/RMS—FILE/FDL command 

5 INDEXFILE.FDL is used to optimize MAKEINDEX.FDL 

The final step in the process would be to enter the following command: 

CONVERT/FDL=MAKEINDEX INDEXFILE.DAT INDEXFILE.DAT 

0 $ EDIT/FDL/N0INT/A=INVENT0RY/G=4 

File: SALES 

$ 


This command creates the output FDL file SALES from the analysis FDL file 
INVENTORY without an interactive terminal dialogue. In addition, EDIT 
/FDL optimizes the input file, changing the granularity factor to four areas 
and the number of keys to two. Otherwise, all the defaults supplied by EDIT 
/FDL are used. 
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Index 


BUCKET_SIZE attribute* FDL-8, FDL-19 

A _ 


ACCESS attribute • FDL-3, FDL-4 
ADD command • FDL-56 
ALLOCATION attribute*FDL-8, FDL-18 
Alternate index *FDL-29 
Alternate key*FDL-6, FDL-29 
ANALYSIS_OF_AREA attribute* FDL-3, FDL-5 
ANALYSIS_OF_KEY attribute • FDL-3, FDL-5 
/ANALYSIS qualifier* FDL-1, FDL-44 
Analyze/RMS_File Utility (ANALYZE/RMS—FILE) • 
FDL-38 

ANALYSIS_OF_AREA section • FDL-5 
ANALYSIS_OF_KEY section • FDL-5 
creating FDL files*FDL-38, FDL-39 
duplicate key values *FDL-6 
Area • FDL-28, FDL-29 

AREA attribute *FDL-3, FDL-7, FDL-27, FDL-28, 
FDL-29, FDL-39 

ASYNCHRONOUS attribute*FDL-11 
ASY option*FDL-11 
Attribute*FDL-3, FDL-43 


B 


BACKUP attribute*FDL-17 
Batch queue 

default *FDL-25 

BEST_TRY_CONTIGUOUS attribute*FDL-8, FDL- 
19 

BIN2 value*FDL-31 
BIN4 value*FDL-31 
BIN8 value*FDL-31 
BIO option • FDL-4, FDL-11 
4-bit field*FDL-31 
BLISS-32 *FDL-40 
BLK option • FDL-32 
BLOCK—10 attribute*FDL-4, FDL-11 
BLOCK-SPAN attribute*FDL-32 
BRIEF prompt • FDL-52 
BRO option*FDL-5 
Bucket*FDL-7, FDL-27 
boundary • FDL-35 
fill* FDL-28 

BUCKET_IO attribute*FDL-1 1 


c 


CARRIAGE-CONTROL attribute • FDL-33 
CARRIAGE-RETURN keyword • FDL-33 
Carriage control 

effect of CARRIAGE-RETURN keyword •FDL- 
33 

Carriage control device*FDL-33 
CBT option*FDL-8, FDL-19 
CCO option*FDL-15 
Cell* FDL-35 

CHANGES attribute*FDL-27 
CIF option • FDL-20 
CLUSTER-SIZE attribute • FDL-19 
Comment 

in FDL files*FDL-39 
Comment character*FDL-39 
Compression • FDL-7, FDL-28 
negative values *FDL-6 
of data record • FDL-27 
within data record *FDL-6 
within primary key*FDL-6, FDL-27 
CONNECT attribute*FDL-3, FDL-10 
CONTEXT attribute*FDL-11, FDL-19 
CONTIGUOUS attribute*FDL-8, FDL-19 
CONTROL_FIELD_SIZE attribute • FDL-34, FDL-35 
Control block*FDL-3 
Convert routines 

creating data files *FDL-40 
Convert Utility (CONVERT) • FDL-5 
creating data files *FDL-40 
FDL output data file*FDL-40 
library routine • FDL-40 
CR character*FDL-34 
CREATE—IF attribute • FDL-20 
CREATE/FDL 

See Create/FDL Utility 

Create/FDL Utility (CREATE/FDL) • FDL-1, FDL-40 
creating data files*FDL-40 
exiting • FDL-2 
invoking • FDL-2 
restrictions • FDL-2 
CREATE command • FDL-1 
CREATE command, DCL* FDL-39 
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Index 


/CREATE qualifier •FDL-1 
EDIT/FDL • FDL-45 
CREATION attribute*FDL-17 
CTG option* FDL-8, FDL-19 
CVT option*FDL-16 


D 


DAT_NCMPR option • FDL-28 
DATA—AREA attribute* FDL-27, FDL-28, FDL-29 
DATA—FILL attribute*FDL-6, FDL-27 
DATA_KEY_COMPRESSION attribute • FDL-6, 
FDL-27 

DATA_RECORD_COMPRESSION attribute • FDL-6, 
FDL-27 

DATA_RECORD_COUNT attribute • FDL-6 
DATA_SPACE_OCCUPIED attribute • FDL-6 
Data bucket*FDL-27 
Data files 

creating* FDL-38 
Data record • FDL-7 
DATE attribute *FDL-3, FDL-16 
Decimal number *FDL-3 
DECIMAL value *FDL-31 
DEFAULT_NAME attribute • FDL-20 
Default extension quantity • FDL-21 
Default protection • FDL-24 
Default value 
AREA* FDL-7 
DATE* FDL-16 
FILE* FDL-17 
key • FDL-26 
RECORD *FDL-32 
SYSTEM *FDL-37 

DEFERRED_WRITE attribute • FDL-20 

DELETE_ON_CLOSE attribute*FDL-20, FDL-25 

DELETE access*FDL-24 

DELETE attribute *FDL-4, FDL-36 

DELETE command • FDL-57 

DEL option *FDL-4, FDL-36 

DEPTH attribute*FDL-6 

DEVICE attribute *FDL-37 

DFW option*FDL-20 

Directing output of CREATE/FDL* FDL-2 

Directing output of EDIT/FDL*FDL-2 

DIRECT OR Y_ENTR Y attribute • FDL-20, FDL-21 

Disk model *FDL-37 

Disk volume transfer*FDL-24 

/DISPLAY qualifier*FDL-1, FDL-46 

DLT option • FDL-20 


Duplicate key*FDL-28 
Duplicate key values*FDL-7 
DUPLICATES_PER_SIDR attribute • FDL-6 
DUPLICATES attribute*FDL-28 


E 


EDIT/FDL Utility (EDIT/FDL) 
commands • FDL-55 

Edit/FDL Utility (EDIT/FDL) • FDL-1, FDL-38, FDL- 
39 

ANALYSIS_OF_KEY section • FDL-5 
creating FDL files*FDL-38 
exiting* FDL-2 
invoking* FDL-2 
Optimize script • FDL-38 
restrictions • FDL-2 
scripts* FDL-60 
Editor 

FDL* FDL-1 
text* FDL-1 

/EMPHASIS qualifier*FDL-1, FDL-47 
END_OF_FILE attribute*FDL-11 
EOF option • FDL-11 
EXACT-POSITIONING attribute • FDL-8 
Example 

modifying an FDL file*FDL-65 
modifying an FDL file noninteractively • FDL-65 
tuning a file*FDL-65 
Exclamation point (!) 

as comment delimiter*FDL-39 
EXECUTE access*FDL-24 
EXIT command 
EDIT/FDL *FDL-58 
Exiting CREATE/FDL*FDL-2 
Exiting EDIT/FDL*FDL-2 
EXPIRATION attribute*FDL-17 
EXTENSION attribute *FDL-9, FDL-21 


F 


FAB$B_BKS field • FDL-19 
FAB$B_DNS field • FDL-20 
FAB$B_FAC field *FDL-4, FDL-5 
FAB$B_FNS field *FDL-23 
FAB$B_FSZ field *FDL-34 
FAB$B_ORG field *FDL-23 
FAB$B_RAT field *FDL-32, FDL-34 
FAB$B_RFM field*FDL-34 
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FABSB—RTV field «FDL-26 
FAB$B_SHR field »FDL-36, FDL-37 
FAB$L _ALQ field • FDL-18 
FAB$L _CTX field • FDL-19 
FAB$L_DNA field* FDL-20 
FAB$L_FNA field* FDL-23 
F AB$I_FOP • FDL-23 

FAB$I_FOP field*FDL-19, FDL-20, FDL-21, 

FDL-22, FDL-23, FDL-24, FDL-25, FDL-26 

FAB$I_MRN field*FDL-21 

FAB$W_BLS field • FDL-22 
FAB$W_DEQ field • FDL-21 
FAB$W_GBC field • FDL-21 
FAB$W_MRS field • FDL-35 
FALSE logical value* FDL-3 
FAST_DELETE attribute*FDL-11 
FDL 

See File Definition Language 
FDLSCRE ATE • FDL-40 
FDL$GENERATE • FDL-40 
FDLSPARSE* FDL-40 
FDL file*FDL-1, FDL-40, FDL-51 

ANALYSIS_OF_AREA section • FDL-5 
comment in*FDL-39 

created with ANALYZE/RMS_FILE • FDL-38 
creating* FDL-38 
with EDIT/FDL*FDL-1, FDL-44 
FDL option • FDL-11 
FDL routine 

creating data files*FDL-40 
File 

attributes* FDL-3 
creating* FDL-38 
FDL* FDL-1 
temporary • FDL-20 
FILE attribute*FDL-3, FDL-17 
File Definition Language (FDL)*FDL-1, FDL-2 
ACCESS attribute • FDL-4 
attributes • FDL-3, FDL-43 
editor* FDL-1 
library routine • FDL-40 
syntax* FDL-38 
File protection*FDL-24 
File specification • FDL-20 
partial • FDL-20 

FILL—BUCKETS attribute • FDL-11 

/FILI_BUCKETS qualifier*FDL-27, FDL-28 

Fill factor*FDL-7, FDL-28 
Fixed control • FDL-33, FDL-34, FDL-35 
FIXED format*FDL-34 
Fixed-length record • FDL-34 
FLG=CHG option*FDL-27 


FLG=DUP option*FDL-28 
FLG=NUL option *FDL-29 
FORMAT attribute*FDL-34 
FORTRAN* FDL-33 
FULL prompt *FDL-52 


G 


GET attribute*FDL-4, FDL-36 

GET option*FDL-4, FDL-36 

GLOBAL -BUFFER-COUNT attribute • FDL-21 

Global buffer*FDL-21 

/GRANULARITY qualifier • FDL-1, FDL-48 

Group number*FDL-23 

GROUP protection code*FDL-24 


H 


Flard-copy terminal output • FDL-52 
FIELP command 
EDIT/FDL • FDL-59 
High-speed terminal output • FDL-52 
HRD option *FDL-9 


i 


IAS*FDL-37, FDL-38 
IDENT attribute*FDL-3, FDL-38 
IDX-NCMPR option*FDL-28 
Index 

levels *FDL-6, FDL-7 
records • FDL-7 

INDEX-AREA attribute• FDL-27, FDL-28, FDL-29 
INDEX-COMPRESSION attribute• FDL-7, FDL-28 
INDEX-FILL attribute*FDL-7, FDL-28 
INDEX-SPACE-OCCUPIED attribute • FDL-7 
INDEXED attribute • FDL-23 
Indexed file 

compression • FDL-28 
duplicate keys*FDL-28 
Level 1 index* FDL-29 
INT2 value *FDL-32 
INT4 value *FDL-32 
INT8 value *FDL-32 
INVOKE command *FDL-54, FDL-60 
Invoking CREATE/FDL* FDL-2 
Invoking EDIT/FDL* FDL-2 
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K 


Key 

alternate *FDL-6 
length* FDL-29 
segment length • FDL-30 
type • FDL-31 

KEY_GREATER_EQUAL attribute • FDL-12 
KEY_GREATER_THAN attribute • FDL-12 
KEY_LIMIT attribute*FDL-12 
KEY_NCMPR option *FDL-27 
KEY_OF_REFERENCE attribute*FDL-12 
KEY attribute*FDL-3, FDL-26, FDL-39 
KEY NULL —VALUE attribute • FDL-29 
KEY PROLOG attribute*FDL-27, FDL-28 
Keyword • FDL-3 

abbreviating • FDL-39 
KGE option*FDL-12 


Magnetic tape (cont'd.) 
files *FDL-22 
starting position • FDL-22 
MANUAL—UNLOCKING attribute • FDL-13 
MAX -RECORD-NUMBER attribute • FDL-21 
MAXIMIZE—VERSION attribute • FDL-21 
MEAN_DATA_LENGTH attribute • FDL-7 
MEAN_INDEX_LENGTH attribute• FDL-7 
MODIFY command *FDL-61 
MSE option *FDL-36 
MT_BLOCK_SIZE attribute • FDL-22 
MT_CLOSE_REWIND attribute • FDL-22 
MT_CURRENT—POSITION attribute • FDL-22 
MT_NOT_EOF attribute • FDL-22 
MT_OPEN_REWIND attribute • FDL-22 
MT_PROTECTION attribute • FDL-22 
MULTIBLOCK_COUNT attribute • FDL-13 
MULTIBUFFER_COUNT attribute • FDL-13 
Multiple areas*FDL-7, FDL-29 
MULTISTREAM attribute*FDL-36 
MXV option*FDL-21 


L 


Language 

native to VAX*FDL-40 
LENGTH attribute*FDL-29, FDL-30 
Length of key segment • FDL-30 
LEVEL1—INDEX—AREA attribute• FDL-27, FDL-28, 
FDL-29 

LEVEL 1 -RECORD-COUNT attribute • FDL-7 

Level of prompting*FDL-52 

LF character*FDL-34 

Library routine*FDL-1, FDL-40 

LIM option*FDL-12 

Line feed • FDL-33 

LOA option *FDL-1 1, FDL-12 

LOCATE-MODE attribute* FDL-12 

LOCK_ON_READ attribute*FDL-12 

LOCK_ON_WRITE attribute*FDL-13 

Logical value*FDL-3 

/LOG qualifier 

CREATE/FDL • FDL-1, FDL-42 



MACRO* FDL-40 
Magnetic tape 

file expiration • FDL-17 
file protection • FDL-22 


N 


NAME attribute *FDL-20, FDL-23, FDL-29 
Native language 
on VAX*FDL-40 
NEF option • FDL-22 
Negative compression • FDL-6 
NFS option • FDL-23 
NIL option • FDL-36 
NLK option • FDL-14 

/NOINTERACTIVE qualifier • FDL-1, FDL-49 
NOLOCK attribute*FDL-14 
NO logical value*FDL-3 
/NOLOG qualifier 

CRE ATE/FDL* FDL-42 
NONE carriage control • FDL-33 
NONEXISTENT-RECORD attribute • FDL-14 
/NOSCRIPT qualifier*FDL-1, FDL-54 
Null 

key value*FDL-29 
string • FDL-3 

NULL_KEY attribute*FDL-29 
NULL-VALUE attribute • FDL-29 
/NUMBER-KEYS qualifier • FDL-1, FDL-50 
Number value • FDL-3 
NXR option*FDL-14 
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R 


OFP option* FDL-23 
Optimize script • FDL-38, FDL-44 
ORGANIZATION attribute • FDL-23 
OUTPUT_FILE—PARSE attribute • FDL-23 
/OUTPUT qualifier* FDL-1 
EDIT/FDL* FDL-51 

/OVERRIDE=ACCESSIBILITY qualifier*FDL-22 
Overwrite tape file* FDL-17 
OWNER attribute*FDL-23 
OWNER protection code*FDL-24 


p 


Parameter 

for VAX RMS*FDL-3 
PMT option *FDL-15 

POSITION attribute *FDL-9, FDL-29, FDL-30 
POS option *FDL-22 
Primary attribute • FDL-3 
PRINT_ON_CLOSE attribute*FDL-23 
PRINT carriage control • FDL-33 
Print queue*FDL-23 
Process default • FDL-30 
batch queue *FDL-25 
print queue*FDL-23 
PROHIBIT attribute *FDL-36 
Prolog 3 file*FDL-27 

compression •FDL-27 / FDL-28 
key segment length*FDL-30 
key segment position*FDL-30 
PROLOG attribute* FDL-27, FDL-28, FDL-30 
/PROMPTING qualifier *FDL-1, FDL-52 
PROTECTION attribute • FDL-24 
Protection code • FDL-24 
PTA option • FDL-15 
PUT attribute *FDL-4, FDL-36 
PUT option *FDL-4, FDL-36 


Q 


QUIT command • FDL-62 


RAB$B_KRF field • FDL-12 

RAB$B_MBC field • FDL-13 

RAB$B_MBF field • FDL-14 

RAB$B_TMO field • FDL-15 

RAB$L_CKT field*FDL-11 

RAB$L_CTX field*FDL-1 1 

RAB$L_FOP field*FDL-15 

RAB$L_ROP field• FDL-11, FDL-12, FDL-13, 

FDL-14, FDL-15, FDL-16 
RAH option • FDL-14 
RCK option • FDL-24 
READ-AHEAD attribute • FDL-14 
READ-CHECK attribute • FDL-24 
READ_REGARDLESS attribute • FDL-14 
READ access*FDL-24 
REA option • FDL-13 
RECLAIMED—SPACE attribute • FDL-5 
Record 

maximum length • FDL-34 
maximum number*FDL-21 
maximum size*FDL-35 
RECORD—10 attribute • FDL-5 
RECORD attribute*FDL-3, FDL-32 
RECORD CONTROL_FIELD_SIZE attribute• FDL-35 
RELATIVE attribute*FDL-23 
Relative file record limit* FDL-21 
Repeating characters• FDL-27, FDL-28 
/RESPONSES qualifier*FDL-1, FDL-53 
Restrictions of CREATE/FDL* FDL-2 
Restrictions of EDIT/FDL* FDL-2 
REVISION attribute*FDL-17, FDL-24 
Revision number*FDL-24 
RLK option*FDL-13 
RM03 device *FDL-37 
RMS (Record Management Services) • FDL-1 
control blocks*FDL-3 
creation-time options • FDL-40 
default *FDL-20 
RMS-11 

stream files*FDL-34 
Version 1.8* FDL-30 
RMS_DEFAULT command • FDL-30 
RNE option • FDL-15 
RNF option • FDL-15 
Routine 

library*FDL-1, FDL-40 
RP06 device *FDL-37 
RRL option • FDL-14 
RSTS/E• FDL-37, FDL-38 
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RSX-11M • FDL-37 # FDL-38 
RSX-11M-PLUS • FDL-37, FDL-38 
RT-11 • FDL-37, FDL-38 
Rules for FDL validity • FDL-38 
RWC option • FDL-22 
RWO option*FDL-22 


s 


SCF option*FDL-25 

/SCRIPT qualifier*FDL-1, FDL-54 

Scripts 

EDIT/FDL • FDL-60 
Secondary attribute • FDL-3 
Segmented key*FDL-30 
SEGn_LENGTH attribute • FDL-30 
SEGn_POSITION attribute*FDL-30 
SEGn secondary • FDL-39 
SEQUENTIAL _ONLY attribute • FDL-24 
SEQUENTIAL attribute • FDL-23 
Sequential file*FDL-25 
SET command *FDL-63 
SHARING attribute*FDL-3, FDL-36 
SHOW RMS_DEFAULT command • FDL-30 
SIDR (secondary index data record) • FDL-6 
SIZE attribute*FDL-34 
SOURCE attribute*FDL-37 
Source line*FDL-39 
Specification 

of file*FDL-20 
SPL option • FDL-23 
SQO option • FDL-24 
Starting position, key*FDL-30 
STREAM—CR format • FDL-34 
STREAM_LF format • FDL-34 
STREAM format*FDL-34 
String value*FDL-3, FDL-32 
Structure 

of indexed file*FDL-30 
SUBMIT_ON—CLOSE attribute*FDL-25 
SUPERSEDE attribute*FDL-25 
SUP option*FDL-25 
Switch • FDL-3 

SYSTEM attribute*FDL-3, FDL-37 
System default • FDL-30 
System manager*FDL-17 
SYSTEM protection code*FDL-24 


T 


Tape 

starting position • FDL-22 
TARGET attribute*FDL-37 
TEF option*FDL-25 
TEMPORARY attribute • FDL-25 
Temporary file*FDL-20, FDL-21 
Text editor 

to create FDL files*FDL-1 
TIMEOUT-ENABLE attribute • FDL-14 
TIMEOUT-PERIOD attribute*FDL-15 
TITLE attribute*FDL-3, FDL-38 
TMD option • FDL-25 
TMO option • FDL-15 
TMP option • FDL-21 
TPT option*FDL-15 
Transfer from disk volumes • FDL-24 
TRUE logical value*FDL-3 
TRUNCATE—ON_CLOSE attribute • FDL-25 
TRUNCATE_ON_PUT attribute*FDL-15 
TRUNCATE attribute • FDL-5 
TT_CANCEL -CONTROL _0 attribute • FDL-15 
TT-PROMPT attribute*FDL-15 
TT_PURGE—TYPE—AHEAD attribute • FDL-15 
TT_READ-NOECHO attribute • FDL-15 
TT_READ-NOFILTER attribute • FDL-15 
TT_UPCASE_INPUT attribute*FDL-16 
TYPE attribute *FDL-29, FDL-30, FDL-31 


u 


UFO option • FDL-25 

UIC (user identification code) • FDL-23 

UIF option • FDL-16 

ULK option*FDL-13 

UNDEFINED format • FDL-34 

Unsegmented key*FDL-29 

UPDATE—IF attribute*FDL-16 

UPDATE attribute*FDL-5, FDL-37 

UPD option*FDL-5, FDL-37 

UPI option*FDL-37 

USER_FILE_OPEN attribute • FDL-25 

USER_INTERLOCK • FDL-37 

User classification*FDL-24 

User number*FDL-23 
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Validity rules • FDL-38, FDL-39 
VARIABLE format • FDL-34 
Variable-length record • FDL-34 
VAX/VMS operating system • FDL-37, FDL-38 
Version number*FDL-21 
VFC record • FDL-33, FDL-34, FDL-35 
format of • FDL-34 
VIEW command*FDL-64 
VOLUME attribute *FDL-9 



w 


XAB$W_DFL field • FDL-27 
XAB$W_GRP field *FDL-23 
XAB$W_IFL field • FDL-28 
XAB$W_MBM field *FDL-23 
X AB$ W_POSO • FDL-30 
XAB$W_POSO field • FDL-30 
XAB$W_PRO field • FDL-24 
XAB$W_RFI field • FDL-9 
XAB$W_RVN field*FDL-24 
XAB$W_VOL field • FDL-9 



YES logical value* FDL-3 


WAIT_FOR_RECORD attribute • FDL-16 
WAT option • FDL-16 
WBH option*FDL-16 
WCK option *FDL-26 
WINDOW_SIZE attribute *FDL-26 


WORLD protection code*FDL-24 
WRITE_BEHIND attribute • FDL-16 
WRITE_CHECK attribute*FDL-26 


WRITE access • FDL-24 



XAB$B_AID field • FDL-7 
XAB$B_ALN field*FDL-9 
XAB$B_AOP field *FDL-8, FDL-9 
XAB$B_DAN field*FDL-27 
XAB$B_DPT field • FDL-32 
XAB$B_FLG field*FDL-27, FDL-28, FDL-29 
XAB$B_IAN field*FDL-28 
XAB$B_LAN field*FDL-29 
XAB$B_MTACC field *FDL-22 
XAB$B_NUL field • FDL-29 
XAB$B_PROLOG field • FDL-30 
XAB$B_REF field • FDL-26 
XAB$B_SIZO field*FDL-29, FDL-30 

XAB$I_ALQ field *FDL-8 

XAB$I_KNM field*FDL-29 

XAB$I_LOC field • FDL-9 

XAB$Q _BDT field • FDL-17 
XAB$Q _CDT field • FDL-17 
XAB$Q _EDT field • FDL-17 
XAB$Q_RDT field.*FDL-17 
XAB$W_DEQ field • FDL-9 
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